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: (String, Boolean)

 

Veröffentlicht: Oktober 2016

Hinweis: Diese API ist jetzt veraltet.

Initialisiert eine neue Instanz der Uri-Klasse mit dem angegebenen URI, wobei die Verwendung der Escapezeichen explizit gesteuert werden kann.

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

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

Parameter

uriString
Type: System.String

Die URI.

dontEscape
Type: System.Boolean

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

Exception Condition
ArgumentNullException

uriString ist null.

UriFormatException

uriStringist leer oder enthält nur Leerzeichen.

- oder -

Das Schema im angegebenen uriString ist ungültig.

- oder -

uriString enthält zu viele Schrägstriche.

- oder -

Das in uriString angegebene Kennwort ist ungültig.

- oder -

Der in uriString angegebene Hostname ist ungültig.

- oder -

Der in uriString angegebene Dateiname ist ungültig.

- oder -

Der in uriString angegebene Benutzername ist ungültig.

- oder -

Der in uriString angegebene Host- oder Zertifizierungsstellenname darf nicht mit umgekehrten Schrägstrichen enden.

- oder -

Die in uriString angegebene Portnummer ist ungültig oder kann nicht analysiert werden.

- oder -

Die Länge von uriString überschreitet 65519 Zeichen.

- oder -

Das in uriString angegebene Schema ist länger als 1023 Zeichen.

- oder -

uriString enthält eine ungültige Zeichenfolge.

- oder -

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

Dieser Konstruktor erstellt ein Uri -Instanz anhand einer URI-Zeichenfolge. Analysiert den URI, und speichert sie im kanonischen Format.

Die dontEscape -Parameter steuert, ob reservierte Zeichen übersetzt werden in Escapesequenzen. Dieser Parameter sollte festgelegt werden, um true nur, wenn Sie sicher, dass sind alle reservierte Zeichen im URI mit Escapezeichen versehen wurde haben. Festlegen des Werts 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 diesen Parameter immer, um festlegen false.

Wenn dontEscape festgelegt ist, um false, der Konstruktor versieht reservierten Zeichen durch stellt sicher, dass alle Vorkommen des Prozentzeichens (%) eine gültige Escapesequenz eingehalten werden. Wenn die Zeichensequenz, die folgenden Prozentsatz nicht gültig ist, wird der Prozentsatz % 25 ersetzt.

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

Das folgende Beispiel erstellt eine Uri -Instanz für die URI-http://www.contoso.com/Hello%20World.htm. Da der enthaltene URI vollständig mit Escapezeichen versehen und im kanonischen Format liegt der dontEscape Parameter kann festgelegt werden, um true.

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

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