Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen

Übersetzung

Original

Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

Uri-Konstruktor (String, Boolean)

.NET Framework 4.5

Andere Versionen

Hinweis: Diese API ist mittlerweile 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)

Syntax

C++

[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: Typ: System.String
Die URI.

dontEscape: Typ: System.Boolean
true , wenn uriString vollständig mit Escapezeichen versehen wurde, andernfalls false. Siehe Hinweise.

Ausnahmen

Ausnahme	Bedingung
ArgumentNullException	uriString ist null.
UriFormatException	uriString ist leer oder enthält nur Leerzeichen. - oder - Das in uriString angegebene Kennwort 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 - Am Ende des in uriString angegeben Hostnamens oder Namens der Zertifizierungsstelle sind umgekehrte Schrägstriche unzulässig. - oder - Die in uriString angegebene Anschlussnummer ist ungültig oder kann nicht analysiert werden. - oder - uriString ist länger als 65519 Zeichen. - oder - Das in uriString angegebene Schema ist länger als 1023 Zeichen. - oder - uriString enthält eine ungültige Zeichensequenz. - oder - Der in uriString angegebene MS DOS-Pfad muss mit c:\\ beginnen.

Ausnahme

Bedingung

ArgumentNullException

uriString ist null.

UriFormatException

uriString ist leer oder enthält nur Leerzeichen.

- oder -

Das in uriString angegebene Kennwort 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 -

Am Ende des in uriString angegeben Hostnamens oder Namens der Zertifizierungsstelle sind umgekehrte Schrägstriche unzulässig.

- oder -

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

- oder -

uriString ist länger als 65519 Zeichen.

- oder -

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

- oder -

uriString enthält eine ungültige Zeichensequenz.

- oder -

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

Hinweise

Dieser Konstruktor erstellt eine Uri-Instanz aus einer URI-Zeichenfolge. Er analysiert den URI und bringt ihn in kanonische Form.

Der dontEscape-Parameter steuert, ob reservierte Zeichen als Escapesequenzen interpretiert werden. Legen Sie diesen Parameter nur auf true fest, wenn Sie sicher sind, dass alle reservierten Zeichen im URI mit Escapezeichen versehen wurden. Das Festlegen dieses Werts auf true für einen URI, der nicht vollständig mit Escapezeichen versehen wurde, kann zu unerwartetem Verhalten führen. Es wird dringend empfohlen, diesen Parameter immer auf false festzulegen.

Wenn dontEscape auf false festgelegt ist, versieht der Konstruktor alle reservierten Zeichen mit Escapezeichen, indem er überprüft, ob auf alle Vorkommen des Prozentzeichens (%) eine gültige Escapesequenz folgt. Wenn die auf das Prozentzeichen folgende Zeichenfolge ungültig ist, wird das Prozentzeichen durch %25 ersetzt.

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

Beispiele

Im folgenden Beispiel wird eine Uri-Instanz aus dem URI "http://www.contoso.com/Hello%20World.htm" erstellt. Da der enthaltene URI vollständig mit Escapezeichen versehen ist und in kanonischer Form vorliegt, kann der Parameter dontEscape auf true festgelegt werden.

C++


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

Versionsinformationen

.NET Framework

Unterstützt in: 1.1, 1.0
Veraltet (Compilerwarnung) in 4.5
Veraltet (Compilerwarnung) in 4
Veraltet (Compilerwarnung) in 3.5
Veraltet (Compilerwarnung) in 3.5 SP1
Veraltet (Compilerwarnung) in 3.0
Veraltet (Compilerwarnung) in 3.0 SP1
Veraltet (Compilerwarnung) in 3.0 SP2
Veraltet (Compilerwarnung) in 2.0
Veraltet (Compilerwarnung) in 2.0 SP1
Veraltet (Compilerwarnung) in 2.0 SP2

.NET Framework Client Profile

Veraltet (Compilerwarnung) in 4
Veraltet (Compilerwarnung) in 3.5 SP1

Plattformen

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Siehe auch

Referenz

Uri Klasse

Uri-Überladung

System-Namespace

Fanden Sie dies hilfreich? Ja Nein

Nicht genau

Keine ausreichende Tiefe

Weitere Codebeispiele erforderlich

Die Übersetzung sollte verbessert werden.

(1500 verbleibende Zeichen)

Community-Beiträge

HINZUFÜGEN