Uri-Konstruktor (Uri, String, Boolean)

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

Syntax

'Declaration
<ObsoleteAttribute("The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")> _
Public Sub New ( _
    baseUri As Uri, _
    relativeUri As String, _
    dontEscape As Boolean _
)
'Usage
Dim baseUri As Uri
Dim relativeUri As String
Dim dontEscape As Boolean

Dim instance As New Uri(baseUri, relativeUri, dontEscape)

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

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

/** @attribute ObsoleteAttribute("The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202") */ 
public Uri (
    Uri baseUri, 
    String relativeUri, 
    boolean dontEscape
)

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

Parameter

• baseUri
  Der Basis-URI.

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

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

Ausnahmen

Hinweise

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 für Aufrufer 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.

Beispiel

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

Dim baseUri As New Uri("https://www.contoso.com")
Dim myUri As New Uri(baseUri, "Hello%20World.htm", False)

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

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

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

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

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