(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

Uri-Konstruktor (Uri, String, Boolean)

Hinweis: Diese API ist mittlerweile 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
Typ: System.Uri
Der Basis-URI.
relativeUri
Typ: System.String
Der relative URI, der dem Basis-URI hinzugefügt werden soll.
dontEscape
Typ: System.Boolean
true , wenn uriString vollständig mit Escapezeichen versehen wurde, andernfalls false. Siehe Hinweise.

AusnahmeBedingung
ArgumentNullException

baseUri ist null.

ArgumentOutOfRangeException

baseUri ist keine absolute Uri-Instanz.

UriFormatException

Der durch Kombination von baseUri und relativeUri erstellte URI ist leer oder enthält nur Leerzeichen.

- oder -

Das Schema, das in dem durch Kombination von baseUri und relativeUri gebildeten URI angegeben ist, ist ungültig.

- oder -

Der durch Kombination von baseUri und relativeUri gebildete URI enthält zu viele Schrägstriche.

- oder -

Das Kennwort, das in dem durch Kombination von baseUri und relativeUri gebildeten URI angegeben ist, ist ungültig.

- oder -

Der Hostname, der in dem durch Kombination von baseUri und relativeUri gebildeten URI angegeben ist, ist ungültig.

- oder -

Der Dateiname, der in dem durch Kombination von baseUri und relativeUri gebildeten URI angegeben ist, ist ungültig.

- oder -

Der Benutzername, der in dem durch Kombination von baseUri und relativeUri gebildeten URI angegeben ist, ist ungültig.

- oder -

Am Ende des Hostnamens oder Namens der Zertifizierungsstelle, der in dem durch Kombination von baseUri und relativeUri gebildeten URI angegeben ist, sind umgekehrte Schrägstriche unzulässig.

- oder -

Die Anschlussnummer, die in dem durch Kombination von baseUri und relativeUri gebildeten URI angegeben ist, ist ungültig oder kann nicht analysiert werden.

- oder -

Der durch Kombination von baseUri und relativeUri gebildete URI ist länger als 65519 Zeichen.

- oder -

Das Schema, das in dem durch Kombination von baseUri und relativeUri gebildeten URI angegeben ist, ist länger als 1023 Zeichen.

- oder -

Der durch Kombination von baseUri und relativeUri gebildeten URI enthält eine ungültige Zeichenfolge.

- oder -

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

Dieser Konstruktor erstellt eine Uri-Instanz durch Kombination von baseUri und relativeUri. Wenn es sich bei dem in relativeUri übergebenen URI um einen absoluten URI (mit Schema, Hostname und optionaler Anschlussnummer) handelt, wird die Uri-Instanz nur aus relativeUri erstellt.

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.

Hinweise zu Aufrufern

Aus Sicherheitsgründen wird empfohlen, dass Ihre Anwendung diesen Konstruktor nicht mit URI-Zeichenfolgen aus nicht vertrauenswürdigen Quellen aufrufen darf und auch dann nicht, wenn dontEscape auf true festgelegt ist. Alternativ können Sie eine URI-Zeichenfolge auf Gültigkeit überprüfen, indem Sie die IsWellFormedOriginalString-Methode aufrufen, bevor Sie diesen Konstruktor aufrufen.

Im folgenden Beispiel wird eine neue Instanz der Uri-Klasse erstellt, wobei die relativen URIs http://www.contoso.com und Hello%20World.htm zu einem absoluten URI kombiniert werden.


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



.NET Framework

Unterstützt in: 1.1, 1.0
Veraltet (Compilerwarnung) in 4.5.2
Veraltet (Compilerwarnung) in 4.5.1
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

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, 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.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft