Uri Konstruktory

Zdroj:

Uri.cs

Zdroj:

Uri.cs

Zdroj:

Uri.cs

public:
 Uri(System::String ^ uriString);

public Uri (string uriString);

new Uri : string -> Uri

Public Sub New (uriString As String)

Parametry

Výjimky

Příklady

Následující příklad vytvoří instanci Uri s identifikátorem URI http://www.contoso.com/.

Uri^ baseUri = gcnew Uri( "http://www.contoso.com/" );

Uri myUri = new Uri("http://www.contoso.com/");

let myUri = Uri "http://www.contoso.com/"

Dim myUri As New Uri("http://www.contoso.com/")

Poznámky

Tento konstruktor vytvoří instanci Uri z řetězce identifikátoru URI. Parsuje identifikátor URI, umístí ho do kanonického formátu a provede všechna požadovaná řídicí kódování.

Tento konstruktor nezajistí, že Uri odkazuje na přístupný prostředek.

Tento konstruktor předpokládá, že string parametr odkazuje na absolutní identifikátor URI a je ekvivalentní volání konstruktoru Uri s UriKind nastavenou na Absolute. Pokud string parametr předaný konstruktoru je relativní identifikátor URI, tento konstruktor vyvolá UriFormatException.

Zdroj:

Uri.cs

Zdroj:

Uri.cs

Zdroj:

Uri.cs

protected:
 Uri(System::Runtime::Serialization::SerializationInfo ^ serializationInfo, System::Runtime::Serialization::StreamingContext streamingContext);

protected Uri (System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected Uri (System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext);

new Uri : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> Uri

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new Uri : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> Uri

Protected Sub New (serializationInfo As SerializationInfo, streamingContext As StreamingContext)

Parametry

Atributy

ObsoleteAttribute

Výjimky

Poznámky

Tento konstruktor implementuje ISerializable rozhraní pro třídu Uri.

Viz také

• serializace XML a SOAP

Zdroj:

Uri.cs

Zdroj:

Uri.cs

Zdroj:

Uri.cs

public:
 Uri(System::String ^ uriString, bool dontEscape);

[System.Obsolete("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);

[System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(string) instead.")]
public Uri (string uriString, bool dontEscape);

[System.Obsolete("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);

public Uri (string uriString, bool dontEscape);

[<System.Obsolete("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")>]
new Uri : string * bool -> Uri

[<System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(string) instead.")>]
new Uri : string * bool -> Uri

[<System.Obsolete("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")>]
new Uri : string * bool -> Uri

new Uri : string * bool -> Uri

Public Sub New (uriString As String, dontEscape As Boolean)

Parametry

Atributy

ObsoleteAttribute

Výjimky

Příklady

Následující příklad vytvoří instanci Uri pro identifikátor URI http://www.contoso.com/Hello%20World.htm. Vzhledem k tomu, že obsažený identifikátor URI je zcela řídicí a je v kanonické podobě, lze parametr dontEscape nastavit na true.

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

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

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

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

Poznámky

Tento konstruktor vytvoří instanci Uri z řetězce identifikátoru URI. Parsuje identifikátor URI a umístí ho do kanonického formátu.

Parametr dontEscape určuje, jestli jsou rezervované znaky přeloženy do řídicích sekvencí. Tento parametr by měl být nastaven na true pouze v případě, že jste si jisti, že všechny rezervované znaky v identifikátoru URI byly uchycené. Nastavení hodnoty na true identifikátoru URI, který nebyl zcela uchycený, může způsobit neočekávané chování. Důrazně doporučujeme, abyste tento parametr vždy nastavili na false.

Pokud je dontEscape nastavena na false, konstruktor ukazuje všechny rezervované znaky tak, že zkontroluje, zda jsou všechny výskyty procent (%) následované platnou řídicí sekvencí. Pokud sekvence znaků za procentem není platná, nahradí se procento %25.

Tento konstruktor nezajistí, že Uri odkazuje na přístupný prostředek.

Zdroj:

Uri.cs

Zdroj:

Uri.cs

Zdroj:

Uri.cs

public:
 Uri(System::String ^ uriString, UriCreationOptions % creationOptions);

public Uri (string uriString, in UriCreationOptions creationOptions);

new Uri : string * UriCreationOptions -> Uri

Public Sub New (uriString As String, ByRef creationOptions As UriCreationOptions)

Parametry

Zdroj:

Uri.cs

Zdroj:

Uri.cs

Zdroj:

Uri.cs

public:
 Uri(System::String ^ uriString, UriKind uriKind);

public Uri (string uriString, UriKind uriKind);

new Uri : string * UriKind -> Uri

Public Sub New (uriString As String, uriKind As UriKind)

Parametry

Výjimky

Poznámky

Relativní a absolutní identifikátory URI mají různá omezení jejich formátu. Například relativní identifikátor URI nevyžaduje schéma ani autoritu. Hodnota zadaná v uriKind musí odpovídat typu identifikátoru URI předaného v uriString. Pokud je však zadán RelativeOrAbsolute, může být řetězec identifikátoru URI relativní nebo absolutní.

Zdroj:

Uri.cs

Zdroj:

Uri.cs

Zdroj:

Uri.cs

public:
 Uri(Uri ^ baseUri, System::String ^ relativeUri);

public Uri (Uri baseUri, string relativeUri);

public Uri (Uri baseUri, string? relativeUri);

new Uri : Uri * string -> Uri

Public Sub New (baseUri As Uri, relativeUri As String)

Parametry

Výjimky

Příklady

Následující příklad vytvoří novou instanci třídy Uri kombinací relativních identifikátorů URI http://www.contoso.com a catalog/shownew.htm vytvořit absolutní identifikátor URI http://www.contoso.com/catalog/shownew.htm.

Uri^ baseUri = gcnew Uri(  "http://www.contoso.com" );
Uri^ myUri = gcnew Uri( baseUri, "catalog/shownew.htm" );
Console::WriteLine( myUri->ToString() );

Uri baseUri = new Uri("http://www.contoso.com");
 Uri myUri = new Uri(baseUri, "catalog/shownew.htm");

Console.WriteLine(myUri.ToString());

let baseUri = Uri "http://www.contoso.com"
let myUri = Uri(baseUri, "catalog/shownew.htm")

printfn $"{myUri}"

Dim baseUri As New Uri("http://www.contoso.com")
Dim myUri As New Uri(baseUri, "catalog/shownew.htm")

Console.WriteLine(myUri.ToString())

Poznámky

Tento konstruktor vytvoří instanci Uri kombinací baseUri a relativeUri. Pokud je relativeUri absolutní identifikátor URI (obsahující schéma, název hostitele a volitelně číslo portu), vytvoří se Uri instance pouze relativeUri.

Pokud má baseUri relativní části (například /api), musí být relativní část ukončena lomítkem (například /api/), pokud je relativní část baseUri zachována v konstruované Uri.

Navíc pokud relativeUri začíná lomítkem, nahradí se jakákoli relativní část baseUri

Tento konstruktor nezajistí, že Uri odkazuje na přístupný prostředek.

Zdroj:

Uri.cs

Zdroj:

Uri.cs

Zdroj:

Uri.cs

public:
 Uri(Uri ^ baseUri, Uri ^ relativeUri);

public Uri (Uri baseUri, Uri relativeUri);

new Uri : Uri * Uri -> Uri

Public Sub New (baseUri As Uri, relativeUri As Uri)

Parametry

Výjimky

Příklady

Tento příklad vytvoří absolutní instanci Uri, absoluteUria relativní instanci UrirelativeUri. Z těchto dvou instancí se vytvoří nová instance UricombinedUri.

// Create an absolute Uri from a string.
String^ addressString1 = "http://www.contoso.com/";
String^ addressString2 = "catalog/shownew.htm?date=today";
Uri^ absoluteUri = gcnew Uri(addressString1);

// Create a relative Uri from a string.  allowRelative = true to allow for 
// creating a relative Uri.
Uri^ relativeUri = gcnew Uri(addressString2);

// Check whether the new Uri is absolute or relative.
if (  !relativeUri->IsAbsoluteUri )
   Console::WriteLine( "{0} is a relative Uri.", relativeUri );

// Create a new Uri from an absolute Uri and a relative Uri.
Uri^ combinedUri = gcnew Uri( absoluteUri,relativeUri );
Console::WriteLine( combinedUri->AbsoluteUri );

// Create an absolute Uri from a string.
Uri absoluteUri = new Uri("http://www.contoso.com/");

// Create a relative Uri from a string.  allowRelative = true to allow for
// creating a relative Uri.
Uri relativeUri = new Uri("/catalog/shownew.htm?date=today", UriKind.Relative);

// Check whether the new Uri is absolute or relative.
if (!relativeUri.IsAbsoluteUri)
    Console.WriteLine("{0} is a relative Uri.", relativeUri);

// Create a new Uri from an absolute Uri and a relative Uri.
Uri combinedUri = new Uri(absoluteUri, relativeUri);
Console.WriteLine(combinedUri.AbsoluteUri);

// Create an absolute Uri from a string.
let absoluteUri = Uri "http://www.contoso.com/"

// Create a relative Uri from a string.  allowRelative = true to allow for
// creating a relative Uri.
let relativeUri = Uri("/catalog/shownew.htm?date=today", UriKind.Relative)

// Check whether the new Uri is absolute or relative.
if not relativeUri.IsAbsoluteUri then
    printfn $"{relativeUri} is a relative Uri."

// Create a new Uri from an absolute Uri and a relative Uri.
let combinedUri = Uri(absoluteUri, relativeUri)
printfn $"{combinedUri.AbsoluteUri}"

    ' Create an absolute Uri from a string.
    Dim absoluteUri As New Uri("http://www.contoso.com/")
    
    ' Create a relative Uri from a string.  allowRelative = true to allow for 
    ' creating a relative Uri.
    Dim relativeUri As New Uri("/catalog/shownew.htm?date=today")
    
    ' Check whether the new Uri is absolute or relative.
    If Not relativeUri.IsAbsoluteUri Then
        Console.WriteLine("{0} is a relative Uri.", relativeUri)
    End If 
    ' Create a new Uri from an absolute Uri and a relative Uri.
    Dim combinedUri As New Uri(absoluteUri, relativeUri)
    Console.WriteLine(combinedUri.AbsoluteUri)

End Sub

Poznámky

Tento konstruktor vytvoří novou instanci Uri kombinací absolutní instance Uri, baseUri, s relativní Uri instance, relativeUri. Pokud je relativeUri absolutní instancí Uri (obsahující schéma, název hostitele a volitelně číslo portu), vytvoří se instance Uri pouze pomocí relativeUri.

Pokud má baseUri relativní části (například /api), musí být relativní část ukončena lomítkem (například /api/), pokud je relativní část baseUri zachována v konstruované Uri.

Navíc pokud relativeUri začíná lomítkem, nahradí se jakákoli relativní část baseUri

Tento konstruktor nezajistí, že Uri odkazuje na přístupný prostředek.

Zdroj:

Uri.cs

Zdroj:

Uri.cs

Zdroj:

Uri.cs

public:
 Uri(Uri ^ baseUri, System::String ^ relativeUri, bool dontEscape);

[System.Obsolete("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);

[System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(Uri, string) instead.")]
public Uri (Uri baseUri, string? relativeUri, bool dontEscape);

[System.Obsolete("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);

public Uri (Uri baseUri, string relativeUri, bool dontEscape);

[System.Obsolete("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);

[<System.Obsolete("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")>]
new Uri : Uri * string * bool -> Uri

[<System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(Uri, string) instead.")>]
new Uri : Uri * string * bool -> Uri

[<System.Obsolete("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")>]
new Uri : Uri * string * bool -> Uri

new Uri : Uri * string * bool -> Uri

Public Sub New (baseUri As Uri, relativeUri As String, dontEscape As Boolean)

Parametry

Atributy

ObsoleteAttribute

Výjimky

Příklady

Následující příklad vytvoří novou instanci třídy Uri kombinací relativních identifikátorů URI http://www.contoso.com a Hello%20World.htm vytvořit absolutní identifikátor URI.

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

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

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

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

Poznámky

Tento konstruktor vytvoří instanci Uri kombinací baseUri a relativeUri. Pokud je identifikátor URI předaný v relativeUri absolutní identifikátor URI (obsahující schéma, název hostitele a volitelně číslo portu), vytvoří se Uri instance pouze relativeUri.

Parametr dontEscape určuje, jestli jsou rezervované znaky přeloženy do řídicích sekvencí. Tento parametr by měl být nastaven na true pouze v případě, že jste si jisti, že všechny rezervované znaky v identifikátoru URI byly uchycené. Nastavení hodnoty na true identifikátoru URI, který nebyl zcela uchycený, může způsobit neočekávané chování. Důrazně doporučujeme, abyste tento parametr vždy nastavili na false. Pokud je dontEscape nastavena na false, konstruktor ukazuje všechny rezervované znaky tak, že zkontroluje, zda jsou všechny výskyty procent (%) následované platnou řídicí sekvencí. Pokud sekvence znaků za procentem není platná, nahradí se procento %25.

Tento konstruktor nezajistí, že Uri odkazuje na přístupný prostředek.

Poznámky pro volající

Z bezpečnostních důvodů by aplikace neměla volat tento konstruktor s řetězci identifikátoru URI z nedůvěryhodných zdrojů a s dontEscape nastavenou na true. Případně můžete zkontrolovat platnost řetězce identifikátoru URI voláním metody IsWellFormedOriginalString() před voláním tohoto konstruktoru.