Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Uri-Konstruktor: (Uri, String, Boolean)

 

Veröffentlicht: Oktober 2016

Hinweis: Diese API ist jetzt veraltet.

Initialisiert eine neue Instanz der Uri-Klasse auf Grundlage des angegebenen Basis-URIs und des angegebenen relativen URIs mit expliziter Steuerung der Escapesequenzen.

Namespace:   System
Assembly:  System (in System.dll)

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

Parameter

baseUri
Type: System.Uri

Der Basis-URI.

relativeUri
Type: System.String

Der relative URI, der dem Basis-URI hinzugefügt werden soll.

dontEscape
Type: System.Boolean

true, wenn uriString vollständig mit Escapezeichen versehen wurde, andernfalls false. Siehe Hinweise.

Exception Condition
ArgumentNullException

baseUri ist null.

ArgumentOutOfRangeException

baseUri ist keine absolute Uri-Instanz.

UriFormatException

Der URI, der aus baseUri und relativeUri kombiniert wurde, ist leer oder enthält nur Leerzeichen.

- oder -

Das Schema, das in dem aus baseUri und relativeUri kombinierten URI angegeben wurde, ist ungültig.

- oder -

Der URI, der aus baseUri und relativeUri kombiniert wurde, enthält zu viele Schrägstriche.

- oder -

Das Kennwort, das in dem aus baseUri und relativeUri kombinierten URI angegeben wurde, ist ungültig.

- oder -

Der Hostname, der in dem aus baseUri und relativeUri kombinierten URI angegeben wurde, ist ungültig.

- oder -

Der Dateiname, der in dem aus baseUri und relativeUri kombinierten URI angegeben wurde, ist ungültig.

- oder -

Der Benutzername, der in dem aus baseUri und relativeUri kombinierten URI angegeben wurde, ist ungültig.

- oder -

Der Host- oder Zertifizierungsstellenname, der in dem aus baseUri und relativeUri kombinierten URI angegeben wurde, darf nicht mit umgekehrten Schrägstrichen enden.

- oder -

Die Portnummer, die in dem aus baseUri und relativeUri kombinierten URI angegeben wurde, ist ungültig oder kann nicht analysiert werden.

- oder -

Der aus baseUri und relativeUri kombinierte URI ist länger als 65.519 Zeichen.

- oder -

Das Schema, das in dem aus baseUri und relativeUri kombinierten URI angegeben wurde, ist länger als 1.023 Zeichen.

- oder -

Der aus baseUri und relativeUri kombinierte URI enthält eine ungültige Zeichenfolge.

- oder -

Der in uriString angegebene MS-DOS-Pfad muss mit „c:\\“ beginnen.

Dieser Konstruktor erstellt ein Uri -Instanz durch Kombination von baseUri und relativeUri. Wenn der URI übergeben relativeUri ist ein absoluter URI (mit Schema, Hostnamen und optional eine Portnummer), die Uri Instanz wird nur mit erstellt relativeUri.

Die dontEscape -Parameter steuert, ob reservierte Zeichen werden als Escapesequenzen. Dieser Parameter sollte festgelegt werden, um true nur, wenn Sie sicher, dass sind alle reservierte Zeichen im URI in Escapesequenzen umgewandelt wurden. Wenn der Wert auf true für ein URI, der nicht vollständig mit Escapezeichen versehen wurde zu unerwartetem Verhalten führen kann. Es wird dringend empfohlen, dass Sie immer diesen Parameter auf false. Wenn dontEscape Wert false, der Konstruktor versieht reservierten Zeichen überprüfen, ob alle Vorkommen des Prozentzeichens (%) eine gültige Escapesequenz folgt. Wenn die Prozentzeichen folgende Zeichenfolge ungültig ist, wird der Prozentsatz % 25 ersetzt.

Dieser Konstruktor stellt nicht sicher, dass die Uri bezieht sich auf eine Ressource zugegriffen werden kann.

Hinweise für Aufrufer:

Aus Sicherheitsgründen wird empfohlen, die Anwendung muss nicht aufrufen dieses Konstruktors mit URI-Zeichenfolgen aus nicht vertrauenswürdigen Quellen und mit dontEscape festgelegt true. Alternativ können Sie eine URI-Zeichenfolge auf Gültigkeit überprüfen, durch Aufrufen der IsWellFormedOriginalString -Methode vor dem Aufruf dieses Konstruktors.

Das folgende Beispiel erstellt eine neue Instanz der der Uri Klasse, indem die relativen URIs http://www.contoso.com und Hello%20World.htm zu einem absoluten URI kombiniert.

Uri baseUri = new Uri("http://www.contoso.com");
Uri myUri = new Uri(baseUri, "Hello%20World.htm",false);

.NET Framework
Verfügbar seit 1.1
Zurück zum Anfang
Anzeigen: