Freigeben über


Uri-Konstruktor (String, Boolean)

HINWEIS: Dieser Konstruktor 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

'Declaration
<ObsoleteAttribute("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 Sub New ( _
    uriString As String, _
    dontEscape As Boolean _
)
'Usage
Dim uriString As String
Dim dontEscape As Boolean

Dim instance As New Uri(uriString, dontEscape)
[ObsoleteAttribute("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
)
[ObsoleteAttribute(L"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
)
/** @attribute ObsoleteAttribute("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, 
    boolean dontEscape
)
ObsoleteAttribute("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 function Uri (
    uriString : String, 
    dontEscape : boolean
)

Parameter

  • uriString
    Der URI.
  • dontEscape
    true, wenn uriString vollständig mit Escapezeichen versehen wurde, andernfalls false. Weitere Informationen finden Sie in den Hinweisen.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentNullException

uriString ist NULL (Nothing in Visual Basic).

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 65534 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.

Beispiel

Im folgenden Beispiel wird eine Uri-Instanz aus dem URI "https://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.

Dim myUri As New Uri("https://www.contoso.com/Hello%20World.htm", True)
Uri myUri = new Uri("https://www.contoso.com/Hello%20World.htm", true);
Uri^ myUri = gcnew Uri(  "https://www.contoso.com/Hello%20World.htm",true );
Uri myUri = new Uri("https://www.contoso.com/Hello%20World.htm", true);
var myUri : Uri = new Uri("https://www.contoso.com/Hello%20World.htm", true);

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

Versionsinformationen

.NET Framework

Unterstützt in: 1.0, 1.1
Veraltet (Compilerwarnung) in 2.0

.NET Compact Framework

Unterstützt in: 1.0
Veraltet (Compilerwarnung) in 2.0

Siehe auch

Referenz

Uri-Klasse
Uri-Member
System-Namespace