Uri Uri Uri Uri Class

Definice

Poskytuje reprezentaci identifikátoru URI ve formě objektu a snadný přístup k částem identifikátoru URI.Provides an object representation of a uniform resource identifier (URI) and easy access to the parts of the URI.

public ref class Uri : System::Runtime::Serialization::ISerializable
[System.ComponentModel.TypeConverter(typeof(System.UriTypeConverter))]
[System.Serializable]
public class Uri : System.Runtime.Serialization.ISerializable
type Uri = class
    interface ISerializable
Public Class Uri
Implements ISerializable
Dědičnost
Atributy
Implementuje

Příklady

Následující příklad vytvoří instanci Uri třídy a použije ji k WebRequest vytvoření instance.The following example creates an instance of the Uri class and uses it to create a WebRequest instance.

Uri^ siteUri = gcnew Uri( "http://www.contoso.com/" );
WebRequest^ wr = WebRequest::Create( siteUri );
Uri siteUri = new Uri("http://www.contoso.com/");
 
WebRequest wr = WebRequest.Create(siteUri);

Dim siteUri As New Uri("http://www.contoso.com/")
        
Dim wr As WebRequest = WebRequest.Create(siteUri)

Poznámky

Identifikátor URI je kompaktní reprezentace prostředku, který je k dispozici pro vaši aplikaci na intranetu nebo Internetu.A URI is a compact representation of a resource available to your application on the intranet or Internet. Uri Třída definuje vlastnosti a metody pro zpracování identifikátorů URI, včetně analýzy, porovnávání a kombinování.The Uri class defines the properties and methods for handling URIs, including parsing, comparing, and combining. Vlastnosti třídy jsou jen pro čtení; Chcete-li vytvořit upravitelný objekt, UriBuilder použijte třídu. UriThe Uri class properties are read-only; to create a modifiable object, use the UriBuilder class.

Relativní identifikátory URI (například "/new/index.htm") musí být rozšířeny vzhledem k základnímu identifikátoru URI, aby byly absolutní.Relative URIs (for example, "/new/index.htm") must be expanded with respect to a base URI so that they are absolute. MakeRelative Metoda je k dispozici pro převod absolutních identifikátorů URI na relativní identifikátory URI v případě potřeby.The MakeRelative method is provided to convert absolute URIs to relative URIs when necessary.

Uri Konstruktory neřídí řetězce identifikátoru URI, pokud řetězec je identifikátor URI ve správném formátu, včetně identifikátoru schématu.The Uri constructors do not escape URI strings if the string is a well-formed URI including a scheme identifier.

Uri Vlastnosti vrátí kanonickou reprezentaci dat v kódu s řídicím znakem, kde jsou všechny znaky s hodnotami Unicode většími než 127 nahrazeny jejich šestnáctkovými ekvivalenty.The Uri properties return a canonical data representation in escaped encoding, with all characters with Unicode values greater than 127 replaced with their hexadecimal equivalents. Chcete-li vložit identifikátor URI v kanonickém Uri tvaru, konstruktor provede následující kroky:To put the URI in canonical form, the Uri constructor performs the following steps:

  • Převede schéma identifikátoru URI na malá písmena.Converts the URI scheme to lowercase.

  • Převede název hostitele na malá písmena.Converts the host name to lowercase.

  • Pokud je název hostitele adresa IPv6, použije se kanonická adresa IPv6.If the host name is an IPv6 address, the canonical IPv6 address is used. Objekt ScopeId a další volitelná data IPv6 se odeberou.ScopeId and other optional IPv6 data are removed.

  • Odebere výchozí a prázdná čísla portů.Removes default and empty port numbers.

  • Převede implicitní cesty k souborům bez schématu file://(například "C:\my\file") na explicitní cesty k souborům pomocí schématu file://.Converts implicit file paths without the file:// scheme (for example, "C:\my\file") to explicit file paths with the file:// scheme.

  • Řídicí znaky (označované také jako procento oktetů kódovaných), které nemají vyhrazený účel, jsou dekódované (označují se také jako neřídící).Escaped characters (also known as percent-encoded octets) that don't have a reserved purpose are decoded (also known as being unescaped). Tyto nerezervované znaky zahrnují velká a malá písmena (% 41-% 5A a% 61-% 7A), desítkové číslice (% 30-% 39), spojovník (% 2D), perioda (% 2E), podtržítko (% 5F) a tilda (% 7E).These unreserved characters include uppercase and lowercase letters (%41-%5A and %61-%7A), decimal digits (%30-%39), hyphen (%2D), period (%2E), underscore (%5F), and tilde (%7E).

  • Canonicalizes cestu pro hierarchické identifikátory URI komprimací sekvencí, jako jsou/./,/.. /a a//(bez ohledu na to, zda je sekvence uvozená).Canonicalizes the path for hierarchical URIs by compacting sequences such as /./, /../, and // (whether or not the sequence is escaped). Všimněte si, že existují některá schémata, pro které nejsou tyto sekvence zkomprimovány.Note that there are some schemes for which these sequences are not compacted.

  • V případě hierarchických identifikátorů URI, pokud hostitel není ukončen lomítkem (/), je přidán jeden.For hierarchical URIs, if the host is not terminated with a forward slash (/), one is added.

  • Ve výchozím nastavení jsou všechny rezervované znaky v identifikátoru URI uvozené řídicími znaky podle dokumentu RFC 2396.By default, any reserved characters in the URI are escaped in accordance with RFC 2396. Toto chování se mění, pokud je povoleno mezinárodní identifikátory prostředků nebo mezinárodní analýza názvu domény, v jakém jsou vyhrazené znaky v identifikátoru URI uvozené řídicími znaky v souladu s RFC 3986 a RFC 3987.This behavior changes if International Resource Identifiers or International Domain Name parsing is enabled in which case reserved characters in the URI are escaped in accordance with RFC 3986 and RFC 3987.

Jako součást kanonikalizace v konstruktoru pro některá schémata, segmenty s tečkou a prázdné segmenty (/./,/.. jsou komprimovány (jinými slovy, jsou odstraněny).As part of canonicalization in the constructor for some schemes, dot-segments and empty segments (/./, /../, and //) are compacted (in other words, they are removed). Schémata, pro které bude identifikátor URI zkomprimovat tyto sekvence, zahrnují http, https, TCP, NET. pipe a NET. TCP.The schemes for which URI will compact these sequences include http, https, tcp, net.pipe, and net.tcp. U některých dalších schémat nejsou tyto sekvence zkomprimovány.For some other schemes, these sequences are not compacted. Tady je postup, jak tato komprimace vypadá v praxi.Here's how this compacting looks in practice.

var uri = new Uri("http://myUrl/../.."); // http scheme, unescaped
OR
var uri = new Uri("http://myUrl/%2E%2E/%2E%2E"); // http scheme, escaped
OR
var uri = new Uri("ftp://myUrl/../.."); // ftp scheme, unescaped
OR
var uri = new Uri("ftp://myUrl/%2E%2E/%2E%2E"); // ftp scheme, escaped

Console.WriteLine(uri.AbsoluteUri);  
Console.WriteLine(uri.PathAndQuery);  

Po spuštění tohoto kódu vrátí následující výstup s řídicími sekvencemi, které jsou v případě potřeby neuvozeny řídicími znaky, a pak se zkomprimuje.When this code is executed, it returns the following output, with the escaped sequences unescaped if necessary and then compacted.

http://myUrl/  
/  

Můžete transformovat obsah Uri třídy z reference s kódovaným identifikátorem URI s odkazem na čitelný odkaz URI ToString pomocí metody.You can transform the contents of the Uri class from an escape encoded URI reference to a readable URI reference by using the ToString method. Všimněte si, že některé vyhrazené znaky mohou být stále uvozeny ve výstupu ToString metody.Note that some reserved characters might still be escaped in the output of the ToString method. To je v rámci podpory jednoznačného rekonstrukce identifikátoru URI z hodnoty vrácené funkcí ToString.This is to support unambiguous reconstruction of a URI from the value returned by ToString.

Některé identifikátory URI zahrnují identifikátor fragmentu nebo dotaz nebo obojí.Some URIs include a fragment identifier or a query or both. Identifikátor fragmentu je libovolný text, který následuje znak čísla (#) bez znaménka číslice; text fragmentu je uložený ve Fragment vlastnosti.A fragment identifier is any text that follows a number sign (#), not including the number sign; the fragment text is stored in the Fragment property. Dotaz na informace je jakýkoli text, který následuje otazník (?) v identifikátoru URI; text dotazu je uložen ve Query vlastnosti.Query information is any text that follows a question mark (?) in the URI; the query text is stored in the Query property.

V .NET Framework verze 1,1, pokud řetězec určený k konstruktoru obsahuje neznámé schéma a "c:\", třída identifikátoru URI vloží "//" za dvojtečku.In the .NET Framework version 1.1, if the string specified to a constructor contains an unknown scheme and "c:\", the Uri class inserts "//" after the colon. Například identifikátor URI xyz:c:\abc je převeden na xyz://c:/abc.For example, the URI xyz:c:\abc is converted to xyz://c:/abc. V .NET Framework verze 2,0 se toto chování odebralo a vzorový řetězec je převeden na xyz:c:/abc.In the .NET Framework version 2.0, this behavior has been removed, and the example string is converted to xyz:c:/abc.

Poznámka

Třída identifikátoru URI podporuje použití IP adres v obou desítkových notaci pro protokol IPv4 a dvojtečku v šestnáctkové soustavě pro protokol IPv6.The URI class supports the use of IP addresses in both quad-notation for IPv4 protocol and colon-hexadecimal for IPv6 protocol. Nezapomeňte uvést adresu IPv6 do hranatých závorek, jako v http://[:: 1].Remember to enclose the IPv6 address in square brackets, as in http://[::1].

Podpora mezinárodních identifikátorů prostředkůInternational Resource Identifier Support

Webové adresy se obvykle vyjadřují pomocí identifikátorů URI, které se skládají z velmi omezené sady znaků:Web addresses are typically expressed using uniform resource identifiers that consist of a very restricted set of characters:

  • Velká a malá písmena ASCII od anglické abecedy.Upper and lower case ASCII letters from the English alphabet.

  • Číslice od 0 do 9.Digits from 0 to 9.

  • Malý počet jiných symbolů ASCII.A small number of other ASCII symbols.

Specifikace identifikátorů URI najdete v dokumentu RFC 2396, RFC 2732, RFC 3986 a v dokumentu RFC 3987 publikovaného sdružením IETF (Internet Engineering Task Force).The specifications for URIs are documented in RFC 2396, RFC 2732, RFC 3986, and RFC 3987 published by the Internet Engineering Task Force (IETF).

S rostoucím počtem internetových zdrojů je potřeba rozlišit potřeby prostředků pomocí jiných jazyků než angličtiny.With the growth of the Internet, there is a growing need to identify resources using languages other than English. Identifikátory, které usnadňují tuto potřebu a povolují znaky jiné než ASCII (znaky ve znakové sadě Unicode/ISO 10646), se nazývají mezinárodní identifikátory prostředků (IRIs).Identifiers which facilitate this need and allow non-ASCII characters (characters in the Unicode/ISO 10646 character set) are known as International Resource Identifiers (IRIs). Specifikace pro IRIs jsou popsané v dokumentu RFC 3987 publikovaném sdružením IETF.The specifications for IRIs are documented in RFC 3987 published by IETF. Použití IRIs umožňuje, aby adresa URL obsahovala znaky Unicode.Using IRIs allows a URL to contain Unicode characters.

Existující Uri třída se rozšířila v .NET Framework v 3.5, 3,0 SP1 a 2,0 SP1, aby poskytovala podporu IRI na základě RFC 3987.The existing Uri class has been extended in .NET Framework v3.5, 3.0 SP1, and 2.0 SP1 to provide IRI support based on RFC 3987. Uživatelé verze .NET Framework starší než verze 4,5 nebudou mít žádnou změnu z chování .NET Framework 2,0, pokud výslovně nepovolí IRI.Users of .NET Framework versions before version 4.5 will not see any change from the .NET Framework 2.0 behavior unless they specifically enable IRI. Tím zajistíte kompatibilitu aplikace s předchozími verzemi .NET Framework.This ensures application compatibility with prior versions of the .NET Framework.

Pokud chcete povolit podporu pro IRI, vyžaduje se následující změna:To enable support for IRI, the following change is required:

  • Určete, jestli se má pro název domény použít analýza v mezinárodní doméně (IDN) a jestli se mají použít pravidla analýzy IRI.Specify whether you want Internationalized Domain Name (IDN) parsing applied to the domain name and whether IRI parsing rules should be applied. To lze provést v souboru Machine. config nebo v souboru App. config .This can be done in the machine.config or in the app.config file. Přidejte například následující:For example, add the following:

    <configuration>  
      <uri>  
      <idn enabled="All" />  
      <iriParsing enabled="true" />  
      </uri>  
    </configuration>  
    

Uživatelé .NET Framework 4,5 a novějších vždycky mají povolený IRI.Users of .NET Framework 4.5 and newer always have IRI enabled. Analýzu IRI nelze změnit pomocí souboru . config .IRI parsing cannot be changed using a .config file.

Povolením IDN převedete všechny jmenovky Unicode v názvu domény na jejich ekvivalenty Punycode.Enabling IDN will convert all Unicode labels in a domain name to their Punycode equivalents. Názvy Punycode obsahují pouze znaky ASCII a vždy začínají předponou Xn---prefix.Punycode names contain only ASCII characters and always start with the xn-- prefix. Důvodem je podpora stávajících serverů DNS na internetu, protože většina serverů DNS podporuje jenom znaky ASCII (viz RFC 3940).The reason for this is to support existing DNS servers on the Internet, since most DNS servers only support ASCII characters (see RFC 3940).

Povolení IRI a IDN má vliv na hodnotu Uri.DnsSafeHost vlastnosti.Enabling IRI and IDN affects the value of the Uri.DnsSafeHost property. Povolení IRI a IDN může Equalstaké změnit chování metod, OriginalString, GetComponentsa IsWellFormedOriginalString .Enabling IRI and IDN can also change the behavior of the Equals, OriginalString, GetComponents, and IsWellFormedOriginalString methods.

Existují tři možné hodnoty pro IDN v závislosti na používaných serverech DNS:There are three possible values for IDN depending on the DNS servers that are used:

  • IDN povolené = všeidn enabled = All

    Tato hodnota převede všechny názvy domén Unicode na jejich ekvivalenty Punycode (názvy IDN).This value will convert any Unicode domain names to their Punycode equivalents (IDN names).

  • povolené IDN = AllExceptIntranetidn enabled = AllExceptIntranet

    Tato hodnota převede všechny názvy domén Unicode, které nejsou v místním intranetu, aby používaly ekvivalenty Punycode (názvy IDN).This value will convert all Unicode domain names not on the local Intranet to use the Punycode equivalents (IDN names). V tomto případě by se měly servery DNS, které se používají pro intranet, podporovat rozlišení názvů Unicode.In this case to handle international names on the local Intranet, the DNS servers that are used for the Intranet should support Unicode name resolution.

  • povoleno IDN = Noneidn enabled = None

    Tato hodnota nepřevede žádné názvy domén Unicode tak, aby používaly Punycode.This value will not convert any Unicode domain names to use Punycode. Jedná se o výchozí hodnotu, která je konzistentní s chováním .NET Framework 2,0.This is the default value which is consistent with the .NET Framework 2.0 behaviour.

Když je povolená analýza IRI (IriParsing Enabled true=), bude provedena normalizace a kontrola znaku podle nejnovějších pravidel IRI v RFC 3986 a RFC 3987.When IRI parsing is enabled (iriParsing enabled = true) normalization and character checking are done according to the latest IRI rules in RFC 3986 and RFC 3987. Když je analýza IRI zakázaná, normalizace a kontrola znaku se provádějí podle RFC 2396 a RFC 2732 (pro literály IPv6).When IRI parsing is disabled, normalization and character checking are performed according to RFC 2396 and RFC 2732 (for IPv6 literals). Ve verzích .NET Framework před verzí 4,5 je falsevýchozí hodnota.In versions of the .NET Framework before version 4.5, the default value is false. V .NET Framework verze 4,5 a novější je truevýchozí hodnota a povolený stav analýzy IRI nelze upravovat pomocí nastavení v souboru . config .In .NET Framework version 4.5 and newer, the default value is true, and the enabled state of IRI parsing cannot be modified by settings in a .config file.

Zpracování IRI a IDN Uri ve třídě lze také ovládat System.Configuration.IriParsingElementpomocí tříd nastavení konfigurace, System.Configuration.IdnElementa. System.Configuration.UriSectionIRI and IDN processing in the Uri class can also be controlled using the System.Configuration.IriParsingElement, System.Configuration.IdnElement, and System.Configuration.UriSection configuration setting classes. Toto System.Configuration.IriParsingElement nastavení povolí nebo zakáže zpracování IRI Uri ve třídě.The System.Configuration.IriParsingElement setting enables or disables IRI processing in the Uri class. Toto System.Configuration.IdnElement nastavení povoluje nebo zakazuje zpracování IDN Uri ve třídě.The System.Configuration.IdnElement setting enables or disables IDN processing in the Uri class. System.Configuration.IriParsingElement Nastavení také nepřímo ovládá IDN.The System.Configuration.IriParsingElement setting also indirectly controls IDN. Aby bylo možné zpracování IDN, musí být zpracování IRI povolené.IRI processing must be enabled for IDN processing to be possible. Pokud je zpracování IRI zakázané, bude zpracování IDN nastavené na výchozí nastavení, kde se používá chování .NET Framework 2,0 pro kompatibilitu a nepoužijí se názvy IDN.If IRI processing is disabled, then IDN processing will be set to the default setting where the .NET Framework 2.0 behavior is used for compatibility and IDN names are not used.

Nastavení konfigurace pro System.Configuration.IriParsingElement a System.Configuration.IdnElement bude načteno jednou při vytvoření první System.Uri třídy.The configuration setting for the System.Configuration.IriParsingElement and System.Configuration.IdnElement will be read once when the first System.Uri class is constructed. Změny nastavení konfigurace po uplynutí této doby se ignorují.Changes to configuration settings after that time are ignored.

System.GenericUriParser Třída byla také rozšířena tak, aby povolovala vytváření přizpůsobitelného analyzátoru, který podporuje IRI a IDN.The System.GenericUriParser class has also been extended to allow creating a customizable parser that supports IRI and IDN. Chování System.GenericUriParser objektu je určeno předáním bitové kombinace hodnot, které jsou k dispozici System.GenericUriParserOptions ve výčtu do System.GenericUriParser konstruktoru.The behavior of a System.GenericUriParser object is specified by passing a bitwise combination of the values available in the System.GenericUriParserOptions enumeration to the System.GenericUriParser constructor. GenericUriParserOptions.IriParsing Typ indikuje, že analyzátor podporuje pravidla analýzy uvedená v dokumentu RFC 3987 pro mezinárodní identifikátory prostředků (IRI).The GenericUriParserOptions.IriParsing type indicates the parser supports the parsing rules specified in RFC 3987 for International Resource Identifiers (IRI). Bez ohledu na to, jestli se používá IRI, se nadiktují výše popsanými konfiguračními hodnotami.Whether IRI is used is dictated by the configuration values previously discussed.

GenericUriParserOptions.Idn Typ indikuje, že analyzátor podporuje analýzu názvů hostitelů (IDN) pro mezinárodní názvy domén (IDN).The GenericUriParserOptions.Idn type indicates the parser supports Internationalized Domain Name (IDN) parsing (IDN) of host names. Bez ohledu na to, jestli se používá IDN, se nadiktují výše popsanými konfiguračními hodnotami.Whether IDN is used is dictated by the configuration values previously discussed.

Podpora implicitních cest k souborůmImplicit File Path Support

Urilze také použít k reprezentaci místních cest systému souborů.Uri can also be used to represent local file system paths. Tyto cesty mohou být zastoupeny explicitně v identifikátorech URI, které začínají schématem File://, a implicitně v identifikátorech URI, které nemají schéma file://.These paths can be represented explicitly in URIs that begin with the file:// scheme, and implicitly in URIs that do not have the file:// scheme. Jako konkrétní příklad jsou následující dva identifikátory URI platné a představují stejnou cestu k souboru:As a concrete example, the following two URIs are both valid, and represent the same file path:

Uri uri1 = new Uri("C:/test/path/file.txt") // Implicit file path.
Uri uri2 = new Uri("file:///C:/test/path/file.txt") // Explicit file path.

Tyto implicitní cesty k souborům nejsou kompatibilní se specifikací identifikátoru URI, takže by se měly zacházet, pokud je to možné.These implicit file paths are not compliant with the URI specification and so should be avoided when possible. Při použití .NET Core v systémech UNIX můžou být implicitní cesty k souborům obzvláště problematické, protože absolutní implicitní cesta k souboru je nerozlišuje od relativní cesty.When using .NET Core on Unix-based systems, implicit file paths can be especially problematic, because an absolute implicit file path is indistinguishable from a relative path. Pokud je tato nejednoznačnost přítomná, Uri je výchozí interpretace cesty jako absolutního identifikátoru URI.When such ambiguity is present, Uri default to interpreting the path as an absolute URI.

Faktory ovlivňující výkonPerformance Considerations

Použijete-li soubor Web. config *, který obsahuje identifikátory URI pro inicializaci aplikace, je pro zpracování identifikátorů URI nutné další čas, pokud jsou jejich identifikátory schématu nestandardní.If you use a *Web.config *file that contains URIs to initialize your application, additional time is required to process the URIs if their scheme identifiers are nonstandard. V takovém případě inicializujte ovlivněné části aplikace v případě potřeby identifikátorů URI, nikoli v počátečním čase.In such a case, initialize the affected parts of your application when the URIs are needed, not at start time.

Poznámky pro volající

Z důvodu zabezpečení by měla aplikace při přijímání Uri instancí z nedůvěryhodných zdrojů a s dontEscape nastavením na truepoužít opatrnost. Můžete kontrolovat platnost řetězce identifikátoru URI voláním IsWellFormedOriginalString() metody.Because of security concerns, your application should use caution when accepting Uri instances from untrusted sources and with dontEscape set to true.You can check a URI string for validity by calling the IsWellFormedOriginalString() method.

Konstruktory

Uri(SerializationInfo, StreamingContext) Uri(SerializationInfo, StreamingContext) Uri(SerializationInfo, StreamingContext) Uri(SerializationInfo, StreamingContext)

Inicializuje novou instanci Uri třídy ze zadaných instancí SerializationInfo tříd a StreamingContext .Initializes a new instance of the Uri class from the specified instances of the SerializationInfo and StreamingContext classes.

Uri(String) Uri(String) Uri(String) Uri(String)

Inicializuje novou instanci Uri třídy se zadaným identifikátorem URI.Initializes a new instance of the Uri class with the specified URI.

Uri(String, Boolean) Uri(String, Boolean) Uri(String, Boolean) Uri(String, Boolean)

Inicializuje novou instanci Uri třídy se zadaným identifikátorem URI s explicitním ovládáním uvozovacího znaku.Initializes a new instance of the Uri class with the specified URI, with explicit control of character escaping.

Uri(String, UriKind) Uri(String, UriKind) Uri(String, UriKind) Uri(String, UriKind)

Inicializuje novou instanci Uri třídy se zadaným identifikátorem URI.Initializes a new instance of the Uri class with the specified URI. Tento konstruktor umožňuje určit, zda je řetězec identifikátoru URI relativním identifikátorem URI, absolutním identifikátorem URI nebo je neurčitý.This constructor allows you to specify if the URI string is a relative URI, absolute URI, or is indeterminate.

Uri(Uri, String) Uri(Uri, String) Uri(Uri, String) 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.Initializes a new instance of the Uri class based on the specified base URI and relative URI string.

Uri(Uri, String, Boolean) Uri(Uri, String, Boolean) Uri(Uri, String, Boolean) Uri(Uri, String, Boolean)

Inicializuje novou instanci Uri třídy na základě zadaných základních a relativních identifikátorů URI s explicitním ovládáním řídicích znaků.Initializes a new instance of the Uri class based on the specified base and relative URIs, with explicit control of character escaping.

Uri(Uri, Uri) Uri(Uri, Uri) Uri(Uri, Uri) Uri(Uri, Uri)

Inicializuje novou instanci Uri třídy na základě kombinace zadané základní Uri instance a relativní Uri instance.Initializes a new instance of the Uri class based on the combination of a specified base Uri instance and a relative Uri instance.

Pole

SchemeDelimiter SchemeDelimiter SchemeDelimiter SchemeDelimiter

Určuje znaky, které oddělují schéma komunikačního protokolu od části adresy identifikátoru URI.Specifies the characters that separate the communication protocol scheme from the address portion of the URI. Toto pole je jen pro čtení.This field is read-only.

UriSchemeFile UriSchemeFile UriSchemeFile UriSchemeFile

Určuje, že identifikátor URI je ukazatel na soubor.Specifies that the URI is a pointer to a file. Toto pole je jen pro čtení.This field is read-only.

UriSchemeFtp UriSchemeFtp UriSchemeFtp UriSchemeFtp

Určuje, že se k identifikátoru URI má přistup prostřednictvím protokol FTP (File Transfer Protocol) (FTP).Specifies that the URI is accessed through the File Transfer Protocol (FTP). Toto pole je jen pro čtení.This field is read-only.

UriSchemeGopher UriSchemeGopher UriSchemeGopher UriSchemeGopher

Určuje, že se k identifikátoru URI má přistup prostřednictvím protokolu Gopher.Specifies that the URI is accessed through the Gopher protocol. Toto pole je jen pro čtení.This field is read-only.

UriSchemeHttp UriSchemeHttp UriSchemeHttp UriSchemeHttp

Určuje, že se k identifikátoru URI má přistup prostřednictvím protokolu HTTP (Hypertext Transfer Protocol).Specifies that the URI is accessed through the Hypertext Transfer Protocol (HTTP). Toto pole je jen pro čtení.This field is read-only.

UriSchemeHttps UriSchemeHttps UriSchemeHttps UriSchemeHttps

Určuje, že se k identifikátoru URI má přistup prostřednictvím protokolu HTTPS (Secure Hypertext Transfer Protocol).Specifies that the URI is accessed through the Secure Hypertext Transfer Protocol (HTTPS). Toto pole je jen pro čtení.This field is read-only.

UriSchemeMailto UriSchemeMailto UriSchemeMailto UriSchemeMailto

Určuje, že identifikátor URI je e-mailová adresa a je k němu přistup prostřednictvím protokolu SMTP (Simple Mail Transport Protocol).Specifies that the URI is an email address and is accessed through the Simple Mail Transport Protocol (SMTP). Toto pole je jen pro čtení.This field is read-only.

UriSchemeNetPipe UriSchemeNetPipe UriSchemeNetPipe UriSchemeNetPipe

Určuje, že se k identifikátoru URI má přistup prostřednictvím schématu NetPipe používaného službou Windows Communication Foundation (WCF).Specifies that the URI is accessed through the NetPipe scheme used by Windows Communication Foundation (WCF). Toto pole je jen pro čtení.This field is read-only.

UriSchemeNetTcp UriSchemeNetTcp UriSchemeNetTcp UriSchemeNetTcp

Určuje, že se k identifikátoru URI má přistup prostřednictvím schématu NetTcp používaného službou Windows Communication Foundation (WCF).Specifies that the URI is accessed through the NetTcp scheme used by Windows Communication Foundation (WCF). Toto pole je jen pro čtení.This field is read-only.

UriSchemeNews UriSchemeNews UriSchemeNews UriSchemeNews

Určuje, že identifikátor URI je skupina internetových zpráv a je k němu přistupovaná prostřednictvím protokolu NNTP (Network News Transport Protocol).Specifies that the URI is an Internet news group and is accessed through the Network News Transport Protocol (NNTP). Toto pole je jen pro čtení.This field is read-only.

UriSchemeNntp UriSchemeNntp UriSchemeNntp UriSchemeNntp

Určuje, že identifikátor URI je skupina internetových zpráv a je k němu přistupovaná prostřednictvím protokolu NNTP (Network News Transport Protocol).Specifies that the URI is an Internet news group and is accessed through the Network News Transport Protocol (NNTP). Toto pole je jen pro čtení.This field is read-only.

Vlastnosti

AbsolutePath AbsolutePath AbsolutePath AbsolutePath

Načte absolutní cestu identifikátoru URI.Gets the absolute path of the URI.

AbsoluteUri AbsoluteUri AbsoluteUri AbsoluteUri

Získá absolutní identifikátor URI.Gets the absolute URI.

Authority Authority Authority Authority

Získá název hostitele DNS (Domain Name System) nebo IP adresu a číslo portu pro server.Gets the Domain Name System (DNS) host name or IP address and the port number for a server.

DnsSafeHost DnsSafeHost DnsSafeHost DnsSafeHost

Získá název hostitele, který je v případě potřeby v případě potřeby zabezpečený pro překlad DNS.Gets a host name that, after being unescaped if necessary, is safe to use for DNS resolution.

Fragment Fragment Fragment Fragment

Načte fragment identifikátoru URI s řídicím znakem.Gets the escaped URI fragment.

Host Host Host Host

Získá hostitelskou komponentu této instance.Gets the host component of this instance.

HostNameType HostNameType HostNameType HostNameType

Získá typ názvu hostitele zadaného v identifikátoru URI.Gets the type of the host name specified in the URI.

IdnHost IdnHost IdnHost IdnHost

V případě potřeby použije Punycode odpovídající mezinárodní název domény (RFC 3490).The RFC 3490 compliant International Domain Name of the host, using Punycode as appropriate. Tento řetězec, který je v případě potřeby bez řídicích znaků, je bezpečné použít pro překlad DNS.This string, after being unescaped if necessary, is safe to use for DNS resolution.

IsAbsoluteUri IsAbsoluteUri IsAbsoluteUri IsAbsoluteUri

Získá, zda Uri je instance absolutní.Gets whether the Uri instance is absolute.

IsDefaultPort IsDefaultPort IsDefaultPort IsDefaultPort

Zjistí, zda je hodnota portu identifikátoru URI výchozím nastavením pro toto schéma.Gets whether the port value of the URI is the default for this scheme.

IsFile IsFile IsFile IsFile

Načte hodnotu, která označuje, jestli Uri je zadaný identifikátor URI souboru.Gets a value indicating whether the specified Uri is a file URI.

IsLoopback IsLoopback IsLoopback IsLoopback

Získá informace o tom Uri , zda zadaný odkaz odkazuje na místního hostitele.Gets whether the specified Uri references the local host.

IsUnc IsUnc IsUnc IsUnc

Vrátí, zda je Uri zadaná cesta UNC (Universal Naming Convention).Gets whether the specified Uri is a universal naming convention (UNC) path.

LocalPath LocalPath LocalPath LocalPath

Načte místní reprezentaci názvu souboru v operačním systému.Gets a local operating-system representation of a file name.

OriginalString OriginalString OriginalString OriginalString

Získá původní řetězec identifikátoru URI, který byl předán Uri konstruktoru.Gets the original URI string that was passed to the Uri constructor.

PathAndQuery PathAndQuery PathAndQuery PathAndQuery

Získá vlastnosti Query a oddělené otazníkem (?). AbsolutePathGets the AbsolutePath and Query properties separated by a question mark (?).

Port Port Port Port

Získá číslo portu tohoto identifikátoru URI.Gets the port number of this URI.

Query Query Query Query

Načte všechny informace dotazu obsažené v zadaném identifikátoru URI.Gets any query information included in the specified URI.

Scheme Scheme Scheme Scheme

Získá název schématu pro tento identifikátor URI.Gets the scheme name for this URI.

Segments Segments Segments Segments

Získá pole obsahující segmenty cesty, které tvoří zadaný identifikátor URI.Gets an array containing the path segments that make up the specified URI.

UserEscaped UserEscaped UserEscaped UserEscaped

Indikuje, že řetězec identifikátoru URI byl před Uri vytvořením instance zcela řídicí.Indicates that the URI string was completely escaped before the Uri instance was created.

UserInfo UserInfo UserInfo UserInfo

Získá uživatelské jméno, heslo nebo jiné informace specifické pro uživatele přidružené k zadanému identifikátoru URI.Gets the user name, password, or other user-specific information associated with the specified URI.

Metody

Canonicalize() Canonicalize() Canonicalize() Canonicalize()

Převede interně uložený identifikátor URI na kanonický tvar.Converts the internally stored URI to canonical form.

CheckHostName(String) CheckHostName(String) CheckHostName(String) CheckHostName(String)

Určuje, zda je zadaný název hostitele platným názvem DNS.Determines whether the specified host name is a valid DNS name.

CheckSchemeName(String) CheckSchemeName(String) CheckSchemeName(String) CheckSchemeName(String)

Určuje, zda je zadaný název schématu platný.Determines whether the specified scheme name is valid.

CheckSecurity() CheckSecurity() CheckSecurity() CheckSecurity()

Volání této metody nemá žádný vliv.Calling this method has no effect.

Compare(Uri, Uri, UriComponents, UriFormat, StringComparison) Compare(Uri, Uri, UriComponents, UriFormat, StringComparison) Compare(Uri, Uri, UriComponents, UriFormat, StringComparison) Compare(Uri, Uri, UriComponents, UriFormat, StringComparison)

Porovná zadané části dvou identifikátorů URI pomocí zadaných pravidel porovnání.Compares the specified parts of two URIs using the specified comparison rules.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Vytvoří objekt, který obsahuje všechny relevantní informace požadované pro vygenerování proxy serveru, který se používá ke komunikaci se vzdáleným objektem.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Porovná Uri dvě instance pro rovnost.Compares two Uri instances for equality.

Escape() Escape() Escape() Escape()

Převede všechny nezabezpečené nebo vyhrazené znaky v součásti Path na jejich hexadecimální reprezentace znaků.Converts any unsafe or reserved characters in the path component to their hexadecimal character representations.

EscapeDataString(String) EscapeDataString(String) EscapeDataString(String) EscapeDataString(String)

Převede řetězec na jeho řídicí znázornění.Converts a string to its escaped representation.

EscapeString(String) EscapeString(String) EscapeString(String) EscapeString(String)

Převede řetězec na jeho řídicí znázornění.Converts a string to its escaped representation.

EscapeUriString(String) EscapeUriString(String) EscapeUriString(String) EscapeUriString(String)

Převede řetězec identifikátoru URI na jeho řídicí znázornění.Converts a URI string to its escaped representation.

FromHex(Char) FromHex(Char) FromHex(Char) FromHex(Char)

Získá desítkovou hodnotu šestnáctkové číslice.Gets the decimal value of a hexadecimal digit.

GetComponents(UriComponents, UriFormat) GetComponents(UriComponents, UriFormat) GetComponents(UriComponents, UriFormat) GetComponents(UriComponents, UriFormat)

Získá zadané součásti aktuální instance pomocí zadaného uvozovacího klíče pro speciální znaky.Gets the specified components of the current instance using the specified escaping for special characters.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Získá hashový kód pro identifikátor URI.Gets the hash code for the URI.

GetLeftPart(UriPartial) GetLeftPart(UriPartial) GetLeftPart(UriPartial) GetLeftPart(UriPartial)

Získá zadanou část Uri instance.Gets the specified portion of a Uri instance.

GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Načte aktuální objekt služby životnosti, který řídí zásady životního cyklu pro tuto instanci.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

Vrátí data potřebná k serializaci aktuální instance.Returns the data needed to serialize the current instance.

GetType() GetType() GetType() GetType()

Type Získá aktuální instanci.Gets the Type of the current instance.

(Inherited from Object)
HexEscape(Char) HexEscape(Char) HexEscape(Char) HexEscape(Char)

Převede zadaný znak na jeho šestnáctkový ekvivalent.Converts a specified character into its hexadecimal equivalent.

HexUnescape(String, Int32) HexUnescape(String, Int32) HexUnescape(String, Int32) HexUnescape(String, Int32)

Převede zadané hexadecimální vyjádření znaku na znak.Converts a specified hexadecimal representation of a character to the character.

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Získá objekt služby životnosti, který řídí zásady životního cyklu pro tuto instanci.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
IsBadFileSystemCharacter(Char) IsBadFileSystemCharacter(Char) IsBadFileSystemCharacter(Char) IsBadFileSystemCharacter(Char)

Vrátí, zda je znak v názvu systému souborů neplatný.Gets whether a character is invalid in a file system name.

IsBaseOf(Uri) IsBaseOf(Uri) IsBaseOf(Uri) IsBaseOf(Uri)

Určuje, zda je Uri aktuální instance základem zadané Uri instance.Determines whether the current Uri instance is a base of the specified Uri instance.

IsExcludedCharacter(Char) IsExcludedCharacter(Char) IsExcludedCharacter(Char) IsExcludedCharacter(Char)

Získá, zda by měl být zadaný znak uvozený řídicím znakem.Gets whether the specified character should be escaped.

IsHexDigit(Char) IsHexDigit(Char) IsHexDigit(Char) IsHexDigit(Char)

Určuje, zda je zadaný znak platnou šestnáctkovou číslicí.Determines whether a specified character is a valid hexadecimal digit.

IsHexEncoding(String, Int32) IsHexEncoding(String, Int32) IsHexEncoding(String, Int32) IsHexEncoding(String, Int32)

Určuje, zda je znak v řetězci kódovaný v šestnáctkové soustavě.Determines whether a character in a string is hexadecimal encoded.

IsReservedCharacter(Char) IsReservedCharacter(Char) IsReservedCharacter(Char) IsReservedCharacter(Char)

Získá, zda je zadaný znak vyhrazeným znakem.Gets whether the specified character is a reserved character.

IsWellFormedOriginalString() IsWellFormedOriginalString() IsWellFormedOriginalString() IsWellFormedOriginalString()

Označuje, zda řetězec použitý k vytvoření tohoto Uri sestavení byl ve správném formátu a není vyžadován k dalšímu uvození řídicím znakem.Indicates whether the string used to construct this Uri was well-formed and is not required to be further escaped.

IsWellFormedUriString(String, UriKind) IsWellFormedUriString(String, UriKind) IsWellFormedUriString(String, UriKind) IsWellFormedUriString(String, UriKind)

Označuje, zda je řetězec ve správném formátu tím, že se pokusí vytvořit identifikátor URI s řetězcem a zajistit, aby řetězec nevyžadoval další uvozovací znaky.Indicates whether the string is well-formed by attempting to construct a URI with the string and ensures that the string does not require further escaping.

MakeRelative(Uri) MakeRelative(Uri) MakeRelative(Uri) MakeRelative(Uri)

Určuje rozdíl mezi dvěma Uri instancemi.Determines the difference between two Uri instances.

MakeRelativeUri(Uri) MakeRelativeUri(Uri) MakeRelativeUri(Uri) MakeRelativeUri(Uri)

Určuje rozdíl mezi dvěma Uri instancemi.Determines the difference between two Uri instances.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Vytvoří kopii aktuálního Objectseznamu.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Vytvoří kopii aktuálního MarshalByRefObject objektu bez podstruktury.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
Parse() Parse() Parse() Parse()

Analyzuje identifikátor URI aktuální instance, aby se zajistilo, že obsahuje všechny součásti potřebné pro platný identifikátor URI.Parses the URI of the current instance to ensure it contains all the parts required for a valid URI.

ToString() ToString() ToString() ToString()

Získá kanonickou řetězcovou reprezentaci pro Uri určenou instanci.Gets a canonical string representation for the specified Uri instance.

TryCreate(String, UriKind, Uri) TryCreate(String, UriKind, Uri) TryCreate(String, UriKind, Uri) TryCreate(String, UriKind, Uri)

Vytvoří nový Uri pomocí zadané String instance a UriKind.Creates a new Uri using the specified String instance and a UriKind.

TryCreate(Uri, String, Uri) TryCreate(Uri, String, Uri) TryCreate(Uri, String, Uri) TryCreate(Uri, String, Uri)

Vytvoří nový Uri pomocí zadaných základních a relativních String instancí.Creates a new Uri using the specified base and relative String instances.

TryCreate(Uri, Uri, Uri) TryCreate(Uri, Uri, Uri) TryCreate(Uri, Uri, Uri) TryCreate(Uri, Uri, Uri)

Vytvoří nový Uri pomocí zadaných základních a relativních Uri instancí.Creates a new Uri using the specified base and relative Uri instances.

Unescape(String) Unescape(String) Unescape(String) Unescape(String)

Převede zadaný řetězec nahrazením libovolných řídicích sekvencí jejich neřídicím znázorněním.Converts the specified string by replacing any escape sequences with their unescaped representation.

UnescapeDataString(String) UnescapeDataString(String) UnescapeDataString(String) UnescapeDataString(String)

Převede řetězec na jeho neřídicí reprezentaci.Converts a string to its unescaped representation.

Operátory

Equality(Uri, Uri) Equality(Uri, Uri) Equality(Uri, Uri) Equality(Uri, Uri)

Určuje, zda Uri mají dvě instance stejnou hodnotu.Determines whether two Uri instances have the same value.

Inequality(Uri, Uri) Inequality(Uri, Uri) Inequality(Uri, Uri) Inequality(Uri, Uri)

Určuje, zda Uri dvě instance nemají stejnou hodnotu.Determines whether two Uri instances do not have the same value.

Explicitní implementace rozhraní

ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Vrátí data potřebná k serializaci aktuální instance.Returns the data needed to serialize the current instance.

Platí pro

Viz také