Uri Konstruktoren

Quelle:

Uri.cs

Quelle:

Uri.cs

Quelle:

Uri.cs

Quelle:

Uri.cs

Quelle:

Uri.cs

public:
 Uri(System::String ^ uriString);

public Uri(string uriString);

new Uri : string -> Uri

Public Sub New (uriString As String)

Parameter

Ausnahmen

Beispiele

Im folgenden Beispiel wird eine Uri Instanz mit dem URI http://www.contoso.com/erstellt.

Uri myUri = new Uri("http://www.contoso.com/");

let myUri = Uri "http://www.contoso.com/"

Dim myUri As New Uri("http://www.contoso.com/")

Hinweise

Dieser Konstruktor erstellt eine Uri Instanz aus einer URI-Zeichenfolge. Er analysiert den URI, platziert ihn in kanonischem Format und macht alle erforderlichen Escapecodierungen.

Dieser Konstruktor stellt nicht sicher, dass der Uri Verweis auf eine barrierefreie Ressource erfolgt.

Wenn die uriString Adresse eine IPv6-Adresse darstellt, muss sie in eckige Klammern eingeschlossen werden, z. B. "http://[2607:f8b0:400d:c06::69]".

Dieser Konstruktor geht davon aus, dass der string Parameter auf einen absoluten URI verweist und dem Aufruf des Konstruktors entspricht, auf UriKind den Uri festgelegt istAbsolute. Wenn der string an den Konstruktor übergebene Parameter ein relativer URI ist, löst dieser Konstruktor einen UriFormatException.

Quelle:

Uri.cs

Quelle:

Uri.cs

Quelle:

Uri.cs

Quelle:

Uri.cs

Quelle:

Uri.cs

protected:
 Uri(System::Runtime::Serialization::SerializationInfo ^ serializationInfo, System::Runtime::Serialization::StreamingContext streamingContext);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected Uri(System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext);

protected Uri(System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new Uri : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> Uri

new Uri : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> Uri

Protected Sub New (serializationInfo As SerializationInfo, streamingContext As StreamingContext)

Parameter

Attribute

ObsoleteAttribute

Ausnahmen

Hinweise

Dieser Konstruktor implementiert die ISerializable Schnittstelle für die Uri Klasse.

Weitere Informationen

• XML- und SOAP-Serialisierung

Quelle:

Uri.cs

Quelle:

Uri.cs

Quelle:

Uri.cs

Quelle:

Uri.cs

Quelle:

Uri.cs

public:
 Uri(System::String ^ uriString, bool dontEscape);

[System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(string) instead.")]
public Uri(string uriString, bool dontEscape);

[System.Obsolete("This constructor has been deprecated. Use Uri(string) instead.")]
public Uri(string uriString, bool dontEscape);

[System.Obsolete("The constructor has been deprecated. Please use new Uri(string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")]
public Uri(string uriString, bool dontEscape);

public Uri(string uriString, bool dontEscape);

[<System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(string) instead.")>]
new Uri : string * bool -> Uri

[<System.Obsolete("This constructor has been deprecated. Use Uri(string) instead.")>]
new Uri : string * bool -> Uri

[<System.Obsolete("The constructor has been deprecated. Please use new Uri(string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")>]
new Uri : string * bool -> Uri

new Uri : string * bool -> Uri

Public Sub New (uriString As String, dontEscape As Boolean)

Parameter

Attribute

ObsoleteAttribute

Ausnahmen

Hinweise

Dieser Konstruktor erstellt eine Uri Instanz aus einer URI-Zeichenfolge. Er analysiert den URI und platziert ihn in kanonischem Format.

Der dontEscape Parameter steuert, ob reservierte Zeichen in Escapesequenzen übersetzt werden. Dieser Parameter sollte nur festgelegt true werden, wenn Sie sicher sind, dass alle reservierten Zeichen im URI escaped wurden. Das Festlegen des Werts true auf einen URI, der nicht vollständig escaped wurde, kann zu unerwartetem Verhalten führen. Es wird dringend empfohlen, diesen Parameter immer auf .false

Wenn dieser Wert auf dontEscape festgelegt falseist, escapet der Konstruktor alle reservierten Zeichen, indem überprüft wird, ob alle Vorkommen von Prozent (%) einer gültigen Escapesequenz folgen. Wenn die Zeichenfolge nach einem Prozent nicht gültig ist, wird der Prozentsatz durch %25ersetzt.

Dieser Konstruktor stellt nicht sicher, dass der Uri Verweis auf eine barrierefreie Ressource erfolgt.

Quelle:

Uri.cs

Quelle:

Uri.cs

Quelle:

Uri.cs

Quelle:

Uri.cs

Quelle:

Uri.cs

public:
 Uri(System::String ^ uriString, UriCreationOptions % creationOptions);

public Uri(string uriString, in UriCreationOptions creationOptions);

new Uri : string * UriCreationOptions -> Uri

Public Sub New (uriString As String, ByRef creationOptions As UriCreationOptions)

Parameter

Quelle:

Uri.cs

Quelle:

Uri.cs

Quelle:

Uri.cs

Quelle:

Uri.cs

Quelle:

Uri.cs

public:
 Uri(System::String ^ uriString, UriKind uriKind);

public Uri(string uriString, UriKind uriKind);

new Uri : string * UriKind -> Uri

Public Sub New (uriString As String, uriKind As UriKind)

Parameter

Ausnahmen

Hinweise

Relative und absolute URIs haben unterschiedliche Einschränkungen für ihr Format. Ein relativer URI erfordert z. B. kein Schema oder eine Autorität. Der angegebene Wert uriKind muss mit dem Typ des übergebenen uriStringURI übereinstimmen. Wenn RelativeOrAbsolute jedoch angegeben, kann die URI-Zeichenfolge relativ oder absolut sein.

For uriString, an IPv6 address in string form must be enclosed within brackets, for example, "http://[2607:f8b0:400d:c06::69]".

Quelle:

Uri.cs

Quelle:

Uri.cs

Quelle:

Uri.cs

Quelle:

Uri.cs

Quelle:

Uri.cs

public:
 Uri(Uri ^ baseUri, System::String ^ relativeUri);

public Uri(Uri baseUri, string relativeUri);

public Uri(Uri baseUri, string? relativeUri);

new Uri : Uri * string -> Uri

Public Sub New (baseUri As Uri, relativeUri As String)

Parameter

Ausnahmen

Beispiele

Im folgenden Beispiel wird eine neue Instanz der Uri Klasse erstellt, indem die relativen URIs http://www.contoso.com kombiniert und catalog/shownew.htm der absolute URI http://www.contoso.com/catalog/shownew.htmerstellt wird.

Uri baseUri = new Uri("http://www.contoso.com");
 Uri myUri = new Uri(baseUri, "catalog/shownew.htm");

Console.WriteLine(myUri.ToString());

let baseUri = Uri "http://www.contoso.com"
let myUri = Uri(baseUri, "catalog/shownew.htm")

printfn $"{myUri}"

Dim baseUri As New Uri("http://www.contoso.com")
Dim myUri As New Uri(baseUri, "catalog/shownew.htm")

Console.WriteLine(myUri.ToString())

Hinweise

Dieser Konstruktor erstellt eine Uri Instanz, indem die baseUri und die relativeUri. Wenn relativeUri es sich um einen absoluten URI handelt (der ein Schema, einen Hostnamen und optional eine Portnummer enthält), wird die Uri Instanz nur relativeUrimit .

Wenn die baseUri relativen Teile (wie /api) vorhanden sind, muss der relative Teil mit einem Schrägstrich (wie /api/) beendet werden, wenn der relative Teil baseUri im konstruierten UriBeibehalten werden soll.

Wenn der relativeUri Anfang mit einem Schrägstrich beginnt, ersetzt er außerdem jeden relativen Teil des baseUri

Dieser Konstruktor stellt nicht sicher, dass der Uri Verweis auf eine barrierefreie Ressource erfolgt.

Quelle:

Uri.cs

Quelle:

Uri.cs

Quelle:

Uri.cs

Quelle:

Uri.cs

Quelle:

Uri.cs

public:
 Uri(Uri ^ baseUri, Uri ^ relativeUri);

public Uri(Uri baseUri, Uri relativeUri);

new Uri : Uri * Uri -> Uri

Public Sub New (baseUri As Uri, relativeUri As Uri)

Parameter

Ausnahmen

Beispiele

In diesem Beispiel wird eine absolute Uri Instanz und absoluteUrieine relative Uri Instanz erstellt. relativeUri Anschließend wird eine neue Uri Instanz combinedUriaus diesen beiden Instanzen erstellt.

// Create an absolute Uri from a string.
Uri absoluteUri = new Uri("http://www.contoso.com/");

// Create a relative Uri from a string.  allowRelative = true to allow for
// creating a relative Uri.
Uri relativeUri = new Uri("/catalog/shownew.htm?date=today", UriKind.Relative);

// Check whether the new Uri is absolute or relative.
if (!relativeUri.IsAbsoluteUri)
    Console.WriteLine("{0} is a relative Uri.", relativeUri);

// Create a new Uri from an absolute Uri and a relative Uri.
Uri combinedUri = new Uri(absoluteUri, relativeUri);
Console.WriteLine(combinedUri.AbsoluteUri);

// Create an absolute Uri from a string.
let absoluteUri = Uri "http://www.contoso.com/"

// Create a relative Uri from a string.  allowRelative = true to allow for
// creating a relative Uri.
let relativeUri = Uri("/catalog/shownew.htm?date=today", UriKind.Relative)

// Check whether the new Uri is absolute or relative.
if not relativeUri.IsAbsoluteUri then
    printfn $"{relativeUri} is a relative Uri."

// Create a new Uri from an absolute Uri and a relative Uri.
let combinedUri = Uri(absoluteUri, relativeUri)
printfn $"{combinedUri.AbsoluteUri}"

    ' Create an absolute Uri from a string.
    Dim absoluteUri As New Uri("http://www.contoso.com/")
    
    ' Create a relative Uri from a string.  allowRelative = true to allow for 
    ' creating a relative Uri.
    Dim relativeUri As New Uri("/catalog/shownew.htm?date=today")
    
    ' Check whether the new Uri is absolute or relative.
    If Not relativeUri.IsAbsoluteUri Then
        Console.WriteLine("{0} is a relative Uri.", relativeUri)
    End If 
    ' Create a new Uri from an absolute Uri and a relative Uri.
    Dim combinedUri As New Uri(absoluteUri, relativeUri)
    Console.WriteLine(combinedUri.AbsoluteUri)

End Sub

Hinweise

Dieser Konstruktor erstellt eine neue Uri Instanz, indem eine absolute Uri Instanz mit baseUrieiner relativen Uri Instanz relativeUrikombiniert wird. Wenn relativeUri es sich um eine absolute Uri Instanz handelt (die ein Schema, einen Hostnamen und optional eine Portnummer enthält), wird die Uri Instanz nur relativeUrimit .

Wenn die baseUri relativen Teile (wie /api) vorhanden sind, muss der relative Teil mit einem Schrägstrich (wie /api/) beendet werden, wenn der relative Teil baseUri im konstruierten UriBeibehalten werden soll.

Wenn der relativeUri Wert mit einem Schrägstrich beginnt, ersetzt er außerdem jeden relativen Teil des baseUri.

Dieser Konstruktor stellt nicht sicher, dass der Uri Verweis auf eine barrierefreie Ressource erfolgt.

Quelle:

Uri.cs

Quelle:

Uri.cs

Quelle:

Uri.cs

Quelle:

Uri.cs

Quelle:

Uri.cs

public:
 Uri(Uri ^ baseUri, System::String ^ relativeUri, bool dontEscape);

[System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(Uri, string) instead.")]
public Uri(Uri baseUri, string? relativeUri, bool dontEscape);

[System.Obsolete("This constructor has been deprecated. Use Uri(Uri, string) instead.")]
public Uri(Uri baseUri, string? relativeUri, bool dontEscape);

[System.Obsolete("The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")]
public Uri(Uri baseUri, string? relativeUri, bool dontEscape);

[System.Obsolete("The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")]
public Uri(Uri baseUri, string relativeUri, bool dontEscape);

public Uri(Uri baseUri, string relativeUri, bool dontEscape);

[<System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(Uri, string) instead.")>]
new Uri : Uri * string * bool -> Uri

[<System.Obsolete("This constructor has been deprecated. Use Uri(Uri, string) instead.")>]
new Uri : Uri * string * bool -> Uri

[<System.Obsolete("The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")>]
new Uri : Uri * string * bool -> Uri

new Uri : Uri * string * bool -> Uri

Public Sub New (baseUri As Uri, relativeUri As String, dontEscape As Boolean)

Parameter

Attribute

ObsoleteAttribute

Ausnahmen

Hinweise

Dieser Konstruktor erstellt eine Uri Instanz durch Kombinieren baseUri und relativeUri. Wenn es sich bei dem übergebenen relativeUri URI um einen absoluten URI handelt (der ein Schema, einen Hostnamen und optional eine Portnummer enthält), wird die Uri Instanz nur relativeUrimit .

Der dontEscape Parameter steuert, ob reservierte Zeichen in Escapesequenzen übersetzt werden. Dieser Parameter sollte nur festgelegt true werden, wenn Sie sicher sind, dass alle reservierten Zeichen im URI escaped wurden. Das Festlegen des Werts true auf einen URI, der nicht vollständig escaped wurde, kann zu unerwartetem Verhalten führen. Es wird dringend empfohlen, diesen Parameter immer auf .false Wenn dieser Wert auf dontEscape festgelegt falseist, escapet der Konstruktor alle reservierten Zeichen, indem überprüft wird, ob alle Vorkommen von Prozent (%) einer gültigen Escapesequenz folgen. Wenn die Zeichenfolge nach einem Prozent nicht gültig ist, wird der Prozentsatz durch %25ersetzt.

Dieser Konstruktor stellt nicht sicher, dass der Uri Verweis auf eine barrierefreie Ressource erfolgt.

Hinweise für Aufrufer

Aufgrund von Sicherheitsbedenken sollte Ihre Anwendung diesen Konstruktor nicht mit URI-Zeichenfolgen aus nicht vertrauenswürdigen Quellen und mit dontEscape "Set" trueaufrufen. Alternativ können Sie eine URI-Zeichenfolge auf Gültigkeit überprüfen, indem Sie die IsWellFormedOriginalString() Methode aufrufen, bevor Sie diesen Konstruktor aufrufen.