Uri Konstruktory
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Inicializuje novou instanci Uri třídy.
Přetížení
| Name | Description |
|---|---|
| Uri(String) |
Inicializuje novou instanci Uri třídy pomocí zadaného identifikátoru URI. |
| Uri(SerializationInfo, StreamingContext) |
Zastaralé.
Inicializuje novou instanci Uri třídy ze zadaných SerializationInfo instancí třídy a StreamingContext třídy. |
| Uri(String, Boolean) |
Zastaralé.
Zastaralé.
Zastaralé.
Zastaralé.
Inicializuje novou instanci Uri třídy se zadaným identifikátorem URI s explicitním řízením znakového escapingu. |
| Uri(String, UriCreationOptions) |
Inicializuje novou instanci Uri třídy se zadaným identifikátorem URI a další UriCreationOptions. |
| Uri(String, UriKind) |
Inicializuje novou instanci Uri třídy pomocí zadaného identifikátoru URI. Tento konstruktor umožňuje určit, jestli je řetězec identifikátoru URI relativní identifikátor URI, absolutní identifikátor URI nebo je neurčitý. |
| Uri(Uri, String) |
Inicializuje novou instanci Uri třídy na základě zadaného základního identifikátoru URI a relativního řetězce identifikátoru URI. |
| Uri(Uri, Uri) |
Inicializuje novou instanci Uri třídy na základě kombinace zadané základní Uri instance a relativní Uri instance. |
| Uri(Uri, String, Boolean) |
Zastaralé.
Zastaralé.
Zastaralé.
Zastaralé.
Inicializuje novou instanci Uri třídy na základě zadané základní a relativní identifikátory URI s explicitním ovládáním znaku escaping. |
Uri(String)
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
Inicializuje novou instanci Uri třídy pomocí zadaného identifikátoru URI.
public:
Uri(System::String ^ uriString);
public Uri(string uriString);
new Uri : string -> Uri
Public Sub New (uriString As String)
Parametry
Výjimky
uriString je null.
uriString je prázdný.
-nebo-
Schéma zadané v uriString není správně vytvořeno. Viz CheckSchemeName(String).
-nebo-
uriString obsahuje příliš mnoho lomítek.
-nebo-
Heslo, název hostitele, název souboru nebo uživatelské jméno zadané v uriString tomto souboru není platné.
-nebo-
Název hostitele nebo autority zadaný v uriString je ukončen zpětnými lomítky.
-nebo-
Zadané číslo uriString portu není platné nebo se nedá analyzovat.
-nebo-
Délka uriString přesahuje 65519 znaků (pouze .NET 9 a starší verze).
-nebo-
Délka schématu zadaného ve uriString více než 1023 znacích.
-nebo-
V znakové sekvenci je neplatná sekvence uriStringznaků .
-nebo-
Cesta MS-DOS zadaná v uriString souboru c:\\.
Příklady
Následující příklad vytvoří Uri instanci s identifikátorem 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ří Uri instanci 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.
uriString Pokud představuje adresu IPv6, musí být uzavřena do závorek, například "http://[2607:f8b0:400d:c06::69]".
Tento konstruktor předpokládá, že string parametr odkazuje na absolutní identifikátor URI a je ekvivalentní volání Uri konstruktoru s UriKind nastavenou na Absolute.
string Pokud je parametr předaný konstruktoru relativní identifikátor URI, tento konstruktor vyvolá výjimku UriFormatException.
Platí pro
Uri(SerializationInfo, StreamingContext)
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
Upozornění
This API supports obsolete formatter-based serialization. It should not be called or extended by application code.
Inicializuje novou instanci Uri třídy ze zadaných SerializationInfo instancí třídy a StreamingContext třídy.
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);
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}")>]
new Uri : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> Uri
new Uri : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> Uri
Protected Sub New (serializationInfo As SerializationInfo, streamingContext As StreamingContext)
Parametry
- serializationInfo
- SerializationInfo
Informace potřebné k serializaci nové Uri instance.
- streamingContext
- StreamingContext
Zdroj serializovaného datového proudu přidruženého k nové Uri instanci.
- Atributy
Výjimky
Parametr serializationInfo obsahuje null identifikátor URI.
Parametr serializationInfo obsahuje identifikátor URI, který je prázdný.
-nebo-
Zadané schéma není správně vytvořeno. Viz CheckSchemeName(String).
-nebo-
Identifikátor URI obsahuje příliš mnoho lomítek.
-nebo-
Heslo, název hostitele, název souboru nebo uživatelské jméno zadané v identifikátoru URI není platné.
-nebo-
Název hostitele nebo autority zadaný v identifikátoru URI je ukončen zpětnými lomítky.
-nebo-
Číslo portu zadané v identifikátoru URI není platné nebo se nedá analyzovat.
-nebo-
Délka identifikátoru URI přesahuje 65519 znaků (pouze .NET 9 a starší verze).
-nebo-
Délka schématu zadaného v identifikátoru URI přesahuje 1023 znaků.
-nebo-
V identifikátoru URI existuje neplatná sekvence znaků.
-nebo-
Cesta MS-DOS zadaná v identifikátoru URI nezačíná na c:\\.
Poznámky
Tento konstruktor implementuje ISerializable rozhraní pro Uri třídu.
Viz také
Platí pro
Uri(String, Boolean)
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
Upozornění
This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(string) instead.
Upozornění
This constructor has been deprecated. Use Uri(string) instead.
Upozornění
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
Upozornění
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
Inicializuje novou instanci Uri třídy se zadaným identifikátorem URI s explicitním řízením znakového escapingu.
public:
Uri(System::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("This constructor has been deprecated. 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. https://go.microsoft.com/fwlink/?linkid=14202")]
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("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(string) instead.")>]
new Uri : string * bool -> Uri
[<System.Obsolete("This constructor has been deprecated. 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. https://go.microsoft.com/fwlink/?linkid=14202")>]
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
- uriString
- String
Řetězec, který identifikuje prostředek, který má být reprezentován Uri instancí. Všimněte si, že adresa IPv6 ve formuláři řetězce musí být uzavřena v hranatých závorkách. Například "http://[2607:f8b0:400d:c06::69]".
- dontEscape
- Boolean
true je-li uriString zcela utekl; falsev opačném případě .
- Atributy
Výjimky
uriString je null.
uriString je prázdná nebo obsahuje pouze mezery.
-nebo-
Schéma zadané v uriString tomto schématu není platné.
-nebo-
uriString obsahuje příliš mnoho lomítek.
-nebo-
Heslo, název hostitele, název souboru nebo uživatelské jméno zadané v uriString tomto souboru není platné.
-nebo-
Název hostitele nebo autority zadaný v uriString je ukončen zpětnými lomítky.
-nebo-
Zadané číslo uriString portu není platné nebo se nedá analyzovat.
-nebo-
Délka uriString přesahuje 65519 znaků (pouze .NET 9 a starší verze).
-nebo-
Délka schématu zadaného ve uriString více než 1023 znacích.
-nebo-
V znakové sekvenci je neplatná sekvence uriStringznaků .
-nebo-
Cesta MS-DOS zadaná v uriString souboru c:\\.
Poznámky
Tento konstruktor vytvoří Uri instanci 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 pouze true v případě, že jste si jisti, že všechny rezervované znaky v identifikátoru URI byly uchycené. Nastavení hodnoty true pro identifikátor 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 dontEscape je nastavena na falsehodnotu , 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.
Platí pro
Uri(String, UriCreationOptions)
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
Inicializuje novou instanci Uri třídy se zadaným identifikátorem URI a další UriCreationOptions.
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
- creationOptions
- UriCreationOptions
Možnosti, které řídí způsob Uri vytváření a chování.
Platí pro
Uri(String, UriKind)
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
Inicializuje novou instanci Uri třídy pomocí zadaného identifikátoru URI. Tento konstruktor umožňuje určit, jestli je řetězec identifikátoru URI relativní identifikátor URI, absolutní identifikátor URI nebo je neurčitý.
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
- uriKind
- UriKind
Určuje, zda je řetězec identifikátoru URI relativní identifikátor URI, absolutní identifikátor URI nebo je neurčitý.
Výjimky
uriKind je neplatný.
uriString je null.
uriString obsahuje relativní identifikátor URI a uriKind je Absolute.
nebo
uriString obsahuje absolutní identifikátor URI a uriKind je Relative.
nebo
uriString je prázdný.
-nebo-
Schéma zadané v uriString není správně vytvořeno. Viz CheckSchemeName(String).
-nebo-
uriString obsahuje příliš mnoho lomítek.
-nebo-
Heslo, název hostitele, název souboru nebo uživatelské jméno zadané v uriString tomto souboru není platné.
-nebo-
Název hostitele nebo autority zadaný v uriString je ukončen zpětnými lomítky.
-nebo-
Zadané číslo uriString portu není platné nebo nelze analyzovat.
-nebo-
Délka uriString přesahuje 65519 znaků (pouze .NET 9 a starší verze).
-nebo-
Délka schématu zadaného ve uriString více než 1023 znacích.
-nebo-
V znakové sekvenci je neplatná sekvence uriStringznaků .
-nebo-
Cesta MS-DOS zadaná v uriString souboru c:\\.
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, kterou zadáte, uriKind se musí shodovat s typem identifikátoru URI předaného .uriString Pokud RelativeOrAbsolute je však zadán, může být řetězec identifikátoru URI relativní nebo absolutní.
V uriStringpřípadě adresy IPv6 ve formuláři řetězce musí být uzavřena v hranatých závorkách, například "http://[2607:f8b0:400d:c06::69]".
Platí pro
Uri(Uri, String)
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
Inicializuje novou instanci Uri třídy na základě zadaného základního identifikátoru URI a relativního řetězce identifikátoru URI.
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
- baseUri
- Uri
Základní identifikátor URI.
- relativeUri
- String
Relativní identifikátor URI, který se má přidat do základního identifikátoru URI.
Výjimky
baseUri je null.
baseUri není absolutní Uri instancí.
Identifikátor URI vytvořený kombinací baseUri a relativeUri je prázdný nebo obsahuje pouze mezery.
-nebo-
Schéma zadané v identifikátoru URI vytvořené kombinací baseUri a relativeUri není platné.
-nebo-
Identifikátor URI vytvořený kombinací baseUri a relativeUri obsahuje příliš mnoho lomítek.
-nebo-
Heslo, název hostitele, název souboru nebo uživatelské jméno zadané v identifikátoru URI vytvořeném kombinací baseUri a relativeUri není platné.
-nebo-
Název hostitele nebo autority zadaný v identifikátoru URI vytvořený kombinací baseUri a relativeUri je ukončen zpětnými lomítky.
-nebo-
Číslo portu zadaného v identifikátoru URI vytvořeném kombinací baseUri a relativeUri není platné nebo nelze analyzovat.
-nebo-
Délka identifikátoru URI vytvořená kombinací baseUri a relativeUri překračuje 65519 znaků (pouze .NET 9 a starší verze).
-nebo-
Délka schématu zadaného v identifikátoru URI, který je tvořen kombinováním baseUri a relativeUri překračuje 1023 znaků.
-nebo-
V identifikátoru URI je neplatná sekvence znaků vytvořená kombinací baseUri a relativeUri.
-nebo-
Cesta MS-DOS zadaná v baseUri souboru c:\\.
Příklady
Následující příklad vytvoří novou instanci Uri třídy kombinováním relativních identifikátorů http://www.contoso.com URI a catalog/shownew.htm vytvořit absolutní identifikátor URI http://www.contoso.com/catalog/shownew.htm.
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ří Uri instanci kombinováním a baseUrirelativeUri. Pokud relativeUri je absolutní identifikátor URI (obsahující schéma, název hostitele a volitelně číslo portu), Uri instance se vytvoří pouze relativeUripomocí .
baseUri Pokud má 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ém Uriobjektu .
Pokud relativeUri navíc začíná lomítkem, nahradí se jakákoli relativní část baseUri
Tento konstruktor nezajistí, že Uri odkazuje na přístupný prostředek.
Platí pro
Uri(Uri, Uri)
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
- 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
baseUri není absolutní Uri instancí.
baseUri je null.
baseUri není absolutní Uri instancí.
Identifikátor URI vytvořený kombinací baseUri a relativeUri je prázdný nebo obsahuje pouze mezery.
-nebo-
Schéma zadané v identifikátoru URI vytvořené kombinací baseUri a relativeUri není platné.
-nebo-
Identifikátor URI vytvořený kombinací baseUri a relativeUri obsahuje příliš mnoho lomítek.
-nebo-
Heslo, název hostitele, název souboru nebo uživatelské jméno zadané v identifikátoru URI vytvořeném kombinací baseUri a relativeUri není platné.
-nebo-
Název hostitele nebo autority zadaný v identifikátoru URI vytvořený kombinací baseUri a relativeUri je ukončen zpětnými lomítky.
-nebo-
Číslo portu zadaného v identifikátoru URI vytvořeném kombinací baseUri a relativeUri není platné nebo nelze analyzovat.
-nebo-
Délka identifikátoru URI vytvořená kombinací baseUri a relativeUri překračuje 65519 znaků (pouze .NET 9 a starší verze).
-nebo-
Délka schématu zadaného v identifikátoru URI, který je tvořen kombinováním baseUri a relativeUri překračuje 1023 znaků.
-nebo-
V identifikátoru URI je neplatná sekvence znaků vytvořená kombinací baseUri a relativeUri.
-nebo-
Cesta MS-DOS zadaná v baseUri souboru c:\\.
Příklady
Tento příklad vytvoří absolutní Uri instanci a relativní Uri instanci , relativeUriabsoluteUri. Z těchto dvou instancí se vytvoří nová Uri instance combinedUri.
// 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 Uri instanci kombinací absolutní Uri instance , baseUris relativní Uri instancí, relativeUri. Pokud relativeUri je absolutní Uri instance (obsahující schéma, název hostitele a volitelně číslo portu), Uri instance se vytvoří pouze relativeUripomocí .
baseUri Pokud má 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ém Uriobjektu .
Navíc, pokud relativeUri začíná lomítkem, pak nahradí jakoukoli relativní část baseUri.
Tento konstruktor nezajistí, že Uri odkazuje na přístupný prostředek.
Platí pro
Uri(Uri, String, Boolean)
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
- Zdroj:
- Uri.cs
Upozornění
This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(Uri, string) instead.
Upozornění
This constructor has been deprecated. Use Uri(Uri, string) instead.
Upozornění
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
Upozornění
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
Inicializuje novou instanci Uri třídy na základě zadané základní a relativní identifikátory URI s explicitním ovládáním znaku escaping.
public:
Uri(Uri ^ baseUri, System::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("This constructor has been deprecated. 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. 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. 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("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(Uri, string) instead.")>]
new Uri : Uri * string * bool -> Uri
[<System.Obsolete("This constructor has been deprecated. 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. https://go.microsoft.com/fwlink/?linkid=14202")>]
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
- baseUri
- Uri
Základní identifikátor URI.
- relativeUri
- String
Relativní identifikátor URI, který se má přidat do základního identifikátoru URI.
- dontEscape
- Boolean
true pokud baseUri a relativeUri jsou zcela uniknuty; jinak , false.
- Atributy
Výjimky
baseUri je null.
baseUri není absolutní Uri instancí.
Identifikátor URI vytvořený kombinací baseUri a relativeUri je prázdný nebo obsahuje pouze mezery.
-nebo-
Schéma zadané v identifikátoru URI vytvořené kombinací baseUri a relativeUri není platné.
-nebo-
Identifikátor URI vytvořený kombinací baseUri a relativeUri obsahuje příliš mnoho lomítek.
-nebo-
Heslo, název hostitele, název souboru nebo uživatelské jméno zadané v identifikátoru URI vytvořeném kombinací baseUri a relativeUri není platné.
-nebo-
Název hostitele nebo autority zadaný v identifikátoru URI vytvořený kombinací baseUri a relativeUri je ukončen zpětnými lomítky.
-nebo-
Číslo portu zadaného v identifikátoru URI vytvořeném kombinací baseUri a relativeUri není platné nebo nelze analyzovat.
-nebo-
Délka identifikátoru URI vytvořená kombinací baseUri a relativeUri překračuje 65519 znaků (pouze .NET 9 a starší verze).
-nebo-
Délka schématu zadaného v identifikátoru URI, který je tvořen kombinováním baseUri a relativeUri překračuje 1023 znaků.
-nebo-
V identifikátoru URI je neplatná sekvence znaků vytvořená kombinací baseUri a relativeUri.
-nebo-
Cesta MS-DOS zadaná v baseUri souboru c:\\.
Poznámky
Tento konstruktor vytvoří Uri instanci kombinováním baseUri a relativeUri. Pokud je předaný relativeUri identifikátor URI absolutní identifikátor URI (obsahující schéma, název hostitele a volitelně číslo portu), Uri vytvoří se instance pouze relativeUripomocí .
Parametr dontEscape určuje, jestli jsou rezervované znaky přeloženy do řídicích sekvencí. Tento parametr by měl být nastaven pouze true v případě, že jste si jisti, že všechny rezervované znaky v identifikátoru URI byly uchycené. Nastavení hodnoty true pro identifikátor 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 dontEscape je nastavena na falsehodnotu , 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 vaše aplikace neměla volat tento konstruktor s řetězci URI z nedůvěryhodných zdrojů a s nastaveným dontEscape na true. Případně můžete zkontrolovat platnost řetězce identifikátoru URI voláním IsWellFormedOriginalString() metody před voláním tohoto konstruktoru.