Uri Uri Uri Uri Class

Tanım

Tekdüzen kaynak tanımlayıcısının (URI) nesne temsilini ve URI'nin bölümlerine kolay erişim sağlar.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
Devralma
Öznitelikler
Uygulamalar

Örnekler

Aşağıdaki örnek, bir örneğini oluşturur. Uri sınıfı ve oluşturmak için kullandığı bir WebRequest örneği.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)

Açıklamalar

Bir URI, intranet veya Internet üzerinde uygulamanız için kullanılabilir bir kaynak compact gösterimidir.A URI is a compact representation of a resource available to your application on the intranet or Internet. Uri Özellikleri ve yöntemleri ayrıştırma, karşılaştırma ve birleştirme içeren URI'leri, işleme için sınıf tanımlar.The Uri class defines the properties and methods for handling URIs, including parsing, comparing, and combining. Uri Sınıfı özellikleri salt okunur özelliktedir; değiştirilebilir bir nesne oluşturmak için kullanın UriBuilder sınıfı.The Uri class properties are read-only; to create a modifiable object, use the UriBuilder class.

Göreli URI'ler (örneğin, "/ new/index.htm") bir temel URI'sini göre mutlak olmaları böylece genişletilmelidir.Relative URIs (for example, "/new/index.htm") must be expanded with respect to a base URI so that they are absolute. MakeRelative Yöntemi, mutlak bir URI göreli URI'ler için gerekli olduğunda dönüştürmek için sağlanır.The MakeRelative method is provided to convert absolute URIs to relative URIs when necessary.

Uri Oluşturucular değil kaçış URI dizeler dize bir düzen tanımlayıcısı dahil olmak üzere doğru biçimlendirilmiş bir URI olması durumunda.The Uri constructors do not escape URI strings if the string is a well-formed URI including a scheme identifier.

Uri Özellikleri kaçan, Unicode değerleri onaltılık eşdeğerleri ile değiştirilen 127'den büyük olan tüm karakterlerle kodlama kurallı veri temsili döndürür.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. Kurallı biçimde URI koymak Uri Oluşturucu aşağıdaki adımları gerçekleştirir:To put the URI in canonical form, the Uri constructor performs the following steps:

  • URI şeması küçük harfe dönüştürür.Converts the URI scheme to lowercase.

  • Ana bilgisayar adı küçük harfe dönüştürür.Converts the host name to lowercase.

  • Konak adı bir IPv6 adresi ise, kurallı bir IPv6 adresi kullanılır.If the host name is an IPv6 address, the canonical IPv6 address is used. ScopeId ve diğer isteğe bağlı bir IPv6 verileri kaldırılır.ScopeId and other optional IPv6 data are removed.

  • Varsayılan ve boş bir bağlantı noktası numaralarını kaldırır.Removes default and empty port numbers.

  • Örtük dosya yolları (örneğin, "C:\my\file") file:// şemasını olmadan açık dosya yolları file:// şemasını ile dönüştürür.Converts implicit file paths without the file:// scheme (for example, "C:\my\file") to explicit file paths with the file:// scheme.

  • Ayrılmış bir amacı olmayan kaçış karakterlerini (sekizli olarak da bilinen yüzde olarak kodlanmış) (diğer adıyla atlanmayan) çözülür.Escaped characters (also known as percent-encoded octets) that don't have a reserved purpose are decoded (also known as being unescaped). Bu ayrılmamış karakterleri büyük harf içerir ve ondalık basamak (% 30-% 39), küçük harf (% 41-% 5A ve % 61-% 7A), kısa çizgi (% 2D), nokta (% 2E) (% 5F) alt çizgi ve tire (% 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).

  • Sıkıştırma dilerle için hiyerarşik bir URI'leri yolu gibi canonicalizes /., / /... /, ve / / (olup olmadığını dizisi kaçış).Canonicalizes the path for hierarchical URIs by compacting sequences such as /./, /../, and // (whether or not the sequence is escaped). Kendisi için bu dizileri değil düzenlenmiş bazı şemaları olduğunu unutmayın.Note that there are some schemes for which these sequences are not compacted.

  • Konak eğik çizgiyle (/) sonlandırılmadı, hiyerarşik bir URI'leri için bir eklenir.For hierarchical URIs, if the host is not terminated with a forward slash (/), one is added.

  • Varsayılan olarak, ayrılmış karakterler URI RFC 2396 uygun olarak atlanır.By default, any reserved characters in the URI are escaped in accordance with RFC 2396. URI içindeki büyük/küçük harf hangi ayrılmış karakter uluslararası kaynak tanımlayıcılarda veya uluslararası etki alanı adı ayrıştırma etkinse, bu davranış değişiklikleri RFC 3986'ya ve RFC 3987 uygun olarak atlanır.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.

Standartlaştırma bazı düzenleri, nokta parçaları ve boş bir segment oluşturucusunda bir parçası olarak (/., / / … /, ve / /) düzenlenmiş (diğer bir deyişle, bunlar kaldırılır).As part of canonicalization in the constructor for some schemes, dot-segments and empty segments (/./, /../, and //) are compacted (in other words, they are removed). Http, https, tcp, net.pipe ve net.tcp URI bu dizileri sıkıştırır düzenleri içerir.The schemes for which URI will compact these sequences include http, https, tcp, net.pipe, and net.tcp. Bu dizileri bazı diğer şemaları için düzenlenmiş değil.For some other schemes, these sequences are not compacted. Bu düzenleme uygulamada nasıl görüneceğini aşağıda verilmiştir.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);  

Bu kod yürütüldüğünde, gerekirse atlatılamayan ve ardından sıkıştırılmış kaçış dizileri ile aşağıdaki çıktıyı döndürür.When this code is executed, it returns the following output, with the escaped sequences unescaped if necessary and then compacted.

http://myUrl/  
/  

İçeriğini dönüştürebilirsiniz Uri kullanılarak okunabilir bir URI başvuru bir kaçış kodlanmış URI başvuru sınıfından ToString yöntemi.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. Bazı ayrılmış karakterleri hala Not çıktısında kaçış ToString yöntemi.Note that some reserved characters might still be escaped in the output of the ToString method. Bu URI tarafından döndürülen değerin benzersiz reconstruction desteklemektir ToString.This is to support unambiguous reconstruction of a URI from the value returned by ToString.

Bazı URI'ler bir parça tanımlayıcısı veya bir sorgu ya da her ikisini de içerir.Some URIs include a fragment identifier or a query or both. Bir sayı işaretinden herhangi bir metin bir parça tanımlayıcısıdır (#), numara işareti; dahil değil parça metin depolanır Fragment özelliği.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. Sorgu, URI bir soru işareti (?) takip eden herhangi bir metin bilgileridir; Sorgu metni depolanan Query özelliği.Query information is any text that follows a question mark (?) in the URI; the query text is stored in the Query property.

.NET Framework sürüm 1.1 bir oluşturucu için belirtilen dize bilinmeyen bir şeması varsa, ve "c:\", URI sınıfı ekler "/ /" iki nokta üst üste sonra.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. Örneğin, URI xyz:c:\abc dönüştürülür xyz://c:/abc.For example, the URI xyz:c:\abc is converted to xyz://c:/abc. .NET Framework sürüm 2. 0'da, bu davranışı kaldırıldı ve örnek dize değerine dönüştürülüp 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.

Not

URI sınıfının IP adresleri IPv4 Protokolü için her iki dört gösterimi ve iki nokta üst üste onaltılık IPv6 protokolü için destekler.The URI class supports the use of IP addresses in both quad-notation for IPv4 protocol and colon-hexadecimal for IPv6 protocol. IPv6 adresi http://[::1 olduğu gibi köşeli parantez içine almanız unutmayın].Remember to enclose the IPv6 address in square brackets, as in http://[::1].

Uluslararası Kaynak Tanımlayıcı DesteğiInternational Resource Identifier Support

Web adresleri genellikle çok kısıtlı bir karakter kümesi oluşur Tekdüzen Kaynak Tanımlayıcıları kullanılarak ifade edilir:Web addresses are typically expressed using uniform resource identifiers that consist of a very restricted set of characters:

  • Büyük ve küçük ASCII harf İngilizce alfabetik.Upper and lower case ASCII letters from the English alphabet.

  • 0'dan 9 basamak.Digits from 0 to 9.

  • Diğer ASCII simgeleri küçük bir sayı.A small number of other ASCII symbols.

Belirtimleri için URI RFC 2396, RFC 2732, RFC 3986'ya ve RFC Internet Engineering Task Force (IETF) tarafından yayınlanan 3987 belgelenmiştir.The specifications for URIs are documented in RFC 2396, RFC 2732, RFC 3986, and RFC 3987 published by the Internet Engineering Task Force (IETF).

Internet büyümesi ile İngilizce dışındaki diller kullanarak kaynakları tanımlamak için artan bir ihtiyacı yoktur.With the growth of the Internet, there is a growing need to identify resources using languages other than English. Bunu kolaylaştırmak ve ASCII olmayan karakterler (Unicode/ISO 10646 karakter kümesindeki karakter) izin tanımlayıcılardan uluslararası kaynak tanımlayıcılarda (sınıflandırma) bilinir.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). Iris belirtimleri RFC IETF tarafından yayımlanan 3987 belgelenmiştir.The specifications for IRIs are documented in RFC 3987 published by IETF. Iris kullanarak Unicode karakterler içerecek şekilde bir URL sağlar.Using IRIs allows a URL to contain Unicode characters.

Varolan Uri sınıfı 3.0 SP1, .NET Framework v3.5 genişletilmişse ve 2.0 SP1 IRI desteği sağlamak için temel RFC 3987 üzerinde.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. IRI bunlar özellikle etkinleştirmediğiniz sürece, kullanıcılar sürüm 4.5 önce .NET Framework sürümlerinin .NET Framework 2.0 davranış herhangi bir değişiklik görmezsiniz.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. Bu, .NET Framework'ün önceki sürümleriyle uygulama uyumluluğu sağlar.This ensures application compatibility with prior versions of the .NET Framework.

IRI desteğini etkinleştirmek için aşağıdaki değişikliği gerekli değildir:To enable support for IRI, the following change is required:

  • IRI ayrıştırma kurallarını uygulanıp ve etki alanı adına uygulanan Uluslararası yapılan etki alanı adı (IDN) ayrıştırma isteyip istemediğinizi belirtin.Specify whether you want Internationalized Domain Name (IDN) parsing applied to the domain name and whether IRI parsing rules should be applied. Bu yapılabilir machine.config veya app.config dosya.This can be done in the machine.config or in the app.config file. Örneğin, aşağıdakileri ekleyin:For example, add the following:

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

.NET Framework 4.5 ve üzeri sürümlerde kullanıcılar, her zaman etkin IRI vardır.Users of .NET Framework 4.5 and newer always have IRI enabled. IRI ayrıştırma değiştirilemiyor kullanarak bir .config dosya.IRI parsing cannot be changed using a .config file.

Bir etki alanı adındaki tüm Unicode etiketleri IDN etkinleştirme Punycode eşdeğerlerine dönüştürür.Enabling IDN will convert all Unicode labels in a domain name to their Punycode equivalents. Zayıf kod adları yalnızca ASCII karakterler içeren ve her zaman xn--önekiyle başlayan.Punycode names contain only ASCII characters and always start with the xn-- prefix. Bunun nedeni çoğu DNS sunucuları yalnızca ASCII karakterleri (bkz. RFC 3940) desteklemediğinden Internet'te mevcut DNS sunucuları desteklemektir.The reason for this is to support existing DNS servers on the Internet, since most DNS servers only support ASCII characters (see RFC 3940).

IRI ve IDN etkinleştirilmesi, değerini etkiler Uri.DnsSafeHost özelliği.Enabling IRI and IDN affects the value of the Uri.DnsSafeHost property. IRI ve IDN etkinleştirme davranışını da değiştirebilir Equals, OriginalString, GetComponents, ve IsWellFormedOriginalString yöntemleri.Enabling IRI and IDN can also change the behavior of the Equals, OriginalString, GetComponents, and IsWellFormedOriginalString methods.

IDN için kullanılan DNS sunucularını bağlı olarak üç olası değer vardır:There are three possible values for IDN depending on the DNS servers that are used:

  • Etkin IDN = Allidn enabled = All

    Bu değer herhangi bir Unicode etki alanı adı Punycode eşdeğerleri (IDN adları) dönüştürür.This value will convert any Unicode domain names to their Punycode equivalents (IDN names).

  • Etkin IDN AllExceptIntranet =idn enabled = AllExceptIntranet

    Bu değer, tüm Unicode olmayan Yerel Intranet Punycode eşdeğerleri (IDN adı) kullanmak için etki alanı adlarına dönüştürür.This value will convert all Unicode domain names not on the local Intranet to use the Punycode equivalents (IDN names). Bu durumda yerel Intranet üzerindeki uluslararası adları işlemek için Intranet için kullanılan DNS sunucularını Unicode ad çözümlemesi desteklemelidir.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.

  • Etkin IDN = yokidn enabled = None

    Bu değer, zayıf kod kullanmak için herhangi bir Unicode etki alanı adı dönüşmez.This value will not convert any Unicode domain names to use Punycode. .NET Framework 2.0 davranışı ile tutarlı olan varsayılan değer budur.This is the default value which is consistent with the .NET Framework 2.0 behaviour.

IRI ayrıştırma etkinleştirildiğinde (etkin iriParsing = true) normalleştirme ve karakter denetimi RFC 3986'ya ve RFC 3987 son IRI kurallara göre gerçekleştirilir.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. IRI ayrıştırma devre dışı bırakıldığında, RFC 2396 ve RFC 2732 göre normalleştirme ve karakter denetimi (IPv6 değişmez değerleri için) gerçekleştirilir.When IRI parsing is disabled, normalization and character checking are performed according to RFC 2396 and RFC 2732 (for IPv6 literals). .NET Framework 4.5 sürümünden önceki sürümlerinde, varsayılan değer: false.In versions of the .NET Framework before version 4.5, the default value is false. .NET Framework sürüm 4.5 ve üzeri sürümlerde, varsayılan değer: true, ve ayarları IRI ayrıştırma etkin durumu değiştirilemez bir .config dosya.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.

IRI ve işleme IDN Uri sınıfı da denetlenebilir kullanarak System.Configuration.IriParsingElement, System.Configuration.IdnElement, ve System.Configuration.UriSection yapılandırma ayarı sınıfları.IRI 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. System.Configuration.IriParsingElement Ayarını etkinleştirir veya işleme IRI devre dışı bırakır Uri sınıfı.The System.Configuration.IriParsingElement setting enables or disables IRI processing in the Uri class. System.Configuration.IdnElement Ayarını etkinleştirir veya işleme IDN devre dışı bırakır Uri sınıfı.The System.Configuration.IdnElement setting enables or disables IDN processing in the Uri class. System.Configuration.IriParsingElement IDN denetimleri de dolaylı olarak ayarlama.The System.Configuration.IriParsingElement setting also indirectly controls IDN. IRI işleme mümkün olması için işleme IDN için etkinleştirilmesi gerekir.IRI processing must be enabled for IDN processing to be possible. IRI işleme devre dışıysa, IDN işleme burada .NET Framework 2.0 davranışı uyumluluk için kullanılır ve IDN adları kullanılmaz varsayılan ayar olarak ayarlanır.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.

Bir yapılandırma ayarı için System.Configuration.IriParsingElement ve System.Configuration.IdnElement ne zaman bir kez okunacak ilk System.Uri sınıf oluşturulur.The configuration setting for the System.Configuration.IriParsingElement and System.Configuration.IdnElement will be read once when the first System.Uri class is constructed. Bu süreden sonra yapılandırma ayarlarında yapılan değişiklikler yok sayılır.Changes to configuration settings after that time are ignored.

System.GenericUriParser Sınıfı da genişletilmişse IRI ve IDN destekleyen özelleştirilebilir bir ayrıştırıcı oluşturma izni.The System.GenericUriParser class has also been extended to allow creating a customizable parser that supports IRI and IDN. Davranışını bir System.GenericUriParser nesnesi Bitsel bir birleşimi kullanılabilir değerler geçirerek belirtildiğinde System.GenericUriParserOptions sabit listesine System.GenericUriParser Oluşturucusu.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 Türünü belirten ayrıştırıcı RFC 3987 içinde belirtilen uluslararası kaynak tanımlayıcı (IRI) ayrıştırma kurallarını destekler.The GenericUriParserOptions.IriParsing type indicates the parser supports the parsing rules specified in RFC 3987 for International Resource Identifiers (IRI). IRI kullanılıp daha önce açıklanan yapılandırma değerleri belirlenmiştir.Whether IRI is used is dictated by the configuration values previously discussed.

GenericUriParserOptions.Idn Türü belirten ayrıştırıcı Uluslararası yapılan etki alanı adı (IDN) ana bilgisayar adlarını (IDN) ayrıştırma destekler.The GenericUriParserOptions.Idn type indicates the parser supports Internationalized Domain Name (IDN) parsing (IDN) of host names. Daha önce açıklanan yapılandırma değerleri IDN kullanılıp kullanılmayacağını belirler.Whether IDN is used is dictated by the configuration values previously discussed.

Örtük dosya yolu desteğiImplicit File Path Support

Uri de yerel dosya sistemi yolları göstermek için kullanılabilir.Uri can also be used to represent local file system paths. Bu yolları temsil edilebilir açıkça file:// şemasını ile başlayan bir URI'leri içinde ve örtük olarak file:// şemasını sahip olmayan bir URI'leri içinde.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. Somut bir örnek olarak aşağıdaki iki bir URI'leri her ikisi de geçerli ve aynı dosya yolunu temsil eder: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.

Bu örtük dosya yolları URI belirtimi ile uyumlu değildir ve bu nedenle mümkün olduğunca kaçınılmalıdır.These implicit file paths are not compliant with the URI specification and so should be avoided when possible. Örtük mutlak dosya yolu olduğundan UNIX tabanlı sistemlerde .NET Core kullanarak örtük dosya yolları özellikle sorunludur olabilir ayırt göreli yolu.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. Bu tür belirsizlik olduğunda Uri varsayılan yolu mutlak bir URI olarak yorumlamak için.When such ambiguity is present, Uri default to interpreting the path as an absolute URI.

Başarım DeğerlendirmeleriPerformance Considerations

Bir *Web.config kullanırsanız * uygulama, ek sürenizi başlatmak için bir URI'leri içeren dosya, kendi düzeni tanımlayıcıları standart olmayan bir URI'leri işlemi için gereklidir.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. Değil başlangıç zamanında bir URI'leri gereklidir, böyle bir durumda, etkilenen uygulamanızın parçalarını başlatın.In such a case, initialize the affected parts of your application when the URIs are needed, not at start time.

Arayanlara Notlar

Güvenlik kaygıları nedeniyle, uygulamanızın kabul dikkatli Uri örnekleri güvenilmeyen kaynaklardan ve ile dontEscape kümesine true. Çağırarak bir URI dizesi geçerliliğini denetleyebilirsiniz IsWellFormedOriginalString() yöntemi.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.

Oluşturucular

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

Yeni bir örneğini başlatır Uri belirtilen örneklerini sınıftan SerializationInfo ve StreamingContext sınıfları.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)

Yeni bir örneğini başlatır Uri Belirtilen URI'yı içeren sınıf.Initializes a new instance of the Uri class with the specified URI.

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

Yeni bir örneğini başlatır Uri açık denetim karakteri kaçış ile belirtilen URI ile sınıfı.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)

Yeni bir örneğini başlatır Uri Belirtilen URI'yı içeren sınıf.Initializes a new instance of the Uri class with the specified URI. Bu oluşturucu, URI dizesinin göreli bir URI mutlak URI veya belirsiz belirtmenize olanak sağlar.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)

Yeni bir örneğini başlatır Uri sınıf tabanlı belirtilen temel URI ve göreli URI dizesi.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)

Yeni bir örneğini başlatır Uri belirtilen temel ve göreli URI'ler, açık denetim karakteri kaçış ile temel sınıf.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)

Yeni bir örneğini başlatır Uri sınıfı belirtilen temel birleşimi üzerinde temel Uri örneği ve bir göreli Uri örneği.Initializes a new instance of the Uri class based on the combination of a specified base Uri instance and a relative Uri instance.

Alanlar

SchemeDelimiter SchemeDelimiter SchemeDelimiter SchemeDelimiter

URI adresi bölümünden iletişim protokol şeması ayıran karakterleri belirtir.Specifies the characters that separate the communication protocol scheme from the address portion of the URI. Bu alan salt okunurdur.This field is read-only.

UriSchemeFile UriSchemeFile UriSchemeFile UriSchemeFile

URI bir dosyaya bir işaretçi olduğunu belirtir.Specifies that the URI is a pointer to a file. Bu alan salt okunurdur.This field is read-only.

UriSchemeFtp UriSchemeFtp UriSchemeFtp UriSchemeFtp

URI Dosya Aktarım Protokolü (FTP) aracılığıyla erişilir belirtir.Specifies that the URI is accessed through the File Transfer Protocol (FTP). Bu alan salt okunurdur.This field is read-only.

UriSchemeGopher UriSchemeGopher UriSchemeGopher UriSchemeGopher

URI Gopher Protokolü aracılığıyla erişilebilen belirtir.Specifies that the URI is accessed through the Gopher protocol. Bu alan salt okunurdur.This field is read-only.

UriSchemeHttp UriSchemeHttp UriSchemeHttp UriSchemeHttp

URI Köprü Metni Aktarım Protokolü (HTTP) aracılığıyla erişilir belirtir.Specifies that the URI is accessed through the Hypertext Transfer Protocol (HTTP). Bu alan salt okunurdur.This field is read-only.

UriSchemeHttps UriSchemeHttps UriSchemeHttps UriSchemeHttps

URI Güvenli Köprü Metni Aktarım Protokolü (HTTPS) üzerinden erişilebilen belirtir.Specifies that the URI is accessed through the Secure Hypertext Transfer Protocol (HTTPS). Bu alan salt okunurdur.This field is read-only.

UriSchemeMailto UriSchemeMailto UriSchemeMailto UriSchemeMailto

URI bir e-posta adresi ve Basit Posta Aktarım Protokolü (SMTP) aracılığıyla erişilen belirtir.Specifies that the URI is an email address and is accessed through the Simple Mail Transport Protocol (SMTP). Bu alan salt okunurdur.This field is read-only.

UriSchemeNetPipe UriSchemeNetPipe UriSchemeNetPipe UriSchemeNetPipe

URI'ın Windows Communication Foundation (WCF) tarafından kullanılan NetPipe şeması aracılığıyla erişilir belirtir.Specifies that the URI is accessed through the NetPipe scheme used by Windows Communication Foundation (WCF). Bu alan salt okunurdur.This field is read-only.

UriSchemeNetTcp UriSchemeNetTcp UriSchemeNetTcp UriSchemeNetTcp

URI'ın Windows Communication Foundation (WCF) tarafından kullanılan NetTcp şeması aracılığıyla erişilir belirtir.Specifies that the URI is accessed through the NetTcp scheme used by Windows Communication Foundation (WCF). Bu alan salt okunurdur.This field is read-only.

UriSchemeNews UriSchemeNews UriSchemeNews UriSchemeNews

URI bir Internet haber grubu ve Ağ Haber Aktarım Protokolü (NNTP) aracılığıyla erişilen belirtir.Specifies that the URI is an Internet news group and is accessed through the Network News Transport Protocol (NNTP). Bu alan salt okunurdur.This field is read-only.

UriSchemeNntp UriSchemeNntp UriSchemeNntp UriSchemeNntp

URI bir Internet haber grubu ve Ağ Haber Aktarım Protokolü (NNTP) aracılığıyla erişilen belirtir.Specifies that the URI is an Internet news group and is accessed through the Network News Transport Protocol (NNTP). Bu alan salt okunurdur.This field is read-only.

Özellikler

AbsolutePath AbsolutePath AbsolutePath AbsolutePath

URI mutlak yolunu alır.Gets the absolute path of the URI.

AbsoluteUri AbsoluteUri AbsoluteUri AbsoluteUri

Mutlak URI'yi alır.Gets the absolute URI.

Authority Authority Authority Authority

Bir sunucu için etki alanı adı sistemi (DNS) ana bilgisayar adı veya IP adresi ve bağlantı noktası numarasını alır.Gets the Domain Name System (DNS) host name or IP address and the port number for a server.

DnsSafeHost DnsSafeHost DnsSafeHost DnsSafeHost

Gerekirse, atlanmamış sonra DNS çözümlemesi için kullanmak üzere güvenli bir ana bilgisayar adı, alır.Gets a host name that, after being unescaped if necessary, is safe to use for DNS resolution.

Fragment Fragment Fragment Fragment

Atlanan URI parçası alır.Gets the escaped URI fragment.

Host Host Host Host

Bu örnek'ın ana bileşenini alır.Gets the host component of this instance.

HostNameType HostNameType HostNameType HostNameType

URI'de belirtilen ana bilgisayar adı türünü alır.Gets the type of the host name specified in the URI.

IdnHost IdnHost IdnHost IdnHost

RFC 3490 uyumlu uluslararası etki alanı adı Punycode uygun şekilde kullanarak, ana bilgisayar.The RFC 3490 compliant International Domain Name of the host, using Punycode as appropriate. Bu dize, sonra gerekirse atlanmayan DNS çözümlemesi için kullanmak güvenlidir.This string, after being unescaped if necessary, is safe to use for DNS resolution.

IsAbsoluteUri IsAbsoluteUri IsAbsoluteUri IsAbsoluteUri

Alır olmadığını Uri örneğidir mutlak.Gets whether the Uri instance is absolute.

IsDefaultPort IsDefaultPort IsDefaultPort IsDefaultPort

Bu düzen için varsayılan bağlantı noktası değeri URI'ın olup olmadığını alır.Gets whether the port value of the URI is the default for this scheme.

IsFile IsFile IsFile IsFile

Belirten bir değer alır olup belirtilen Uri URI dosyasıdır.Gets a value indicating whether the specified Uri is a file URI.

IsLoopback IsLoopback IsLoopback IsLoopback

Alır olup belirtilen Uri yerel ana başvuruyor.Gets whether the specified Uri references the local host.

IsUnc IsUnc IsUnc IsUnc

Alır olup belirtilen Uri olan bir Evrensel Adlandırma Kuralı (UNC) yolu.Gets whether the specified Uri is a universal naming convention (UNC) path.

LocalPath LocalPath LocalPath LocalPath

Bir dosya adı bir yerel işletim sistemi gösterimini alır.Gets a local operating-system representation of a file name.

OriginalString OriginalString OriginalString OriginalString

Geçildi özgün bir URI dizesini alır Uri Oluşturucusu.Gets the original URI string that was passed to the Uri constructor.

PathAndQuery PathAndQuery PathAndQuery PathAndQuery

Alır AbsolutePath ve Query özellikleri ayrılmış bir soru işareti (?).Gets the AbsolutePath and Query properties separated by a question mark (?).

Port Port Port Port

Bu URI bağlantı noktası numarasını alır.Gets the port number of this URI.

Query Query Query Query

Belirtilen URI'de dahil herhangi bir sorgu bilgi alır.Gets any query information included in the specified URI.

Scheme Scheme Scheme Scheme

Bu URI için düzen adını alır.Gets the scheme name for this URI.

Segments Segments Segments Segments

Belirtilen URI yapmak yol segmentleri içeren bir dizi alır.Gets an array containing the path segments that make up the specified URI.

UserEscaped UserEscaped UserEscaped UserEscaped

Önce URI dizesinin tamamen kaçış olduğunu gösteren Uri örneği oluşturuldu.Indicates that the URI string was completely escaped before the Uri instance was created.

UserInfo UserInfo UserInfo UserInfo

Kullanıcı adı, parola veya belirtilen URI ile ilişkili diğer kullanıcıya özgü bilgileri alır.Gets the user name, password, or other user-specific information associated with the specified URI.

Yöntemler

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

Dahili olarak depolanan URI canonical biçimine dönüştürür.Converts the internally stored URI to canonical form.

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

Belirtilen konak adı geçerli bir DNS adı olup olmadığını belirler.Determines whether the specified host name is a valid DNS name.

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

Belirtilen şema adının geçerli olup olmadığını belirler.Determines whether the specified scheme name is valid.

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

Bu yöntemin çağrılması, hiçbir etkisi olmaz.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)

Belirtilen karşılaştırma kurallarını kullanarak iki bir URI'leri belirli bölümlerini karşılaştırır.Compares the specified parts of two URIs using the specified comparison rules.

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

Uzak bir nesne ile iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken ilgili bilgileri içeren bir nesne oluşturur.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)

İki karşılaştırır Uri örneği eşitlik.Compares two Uri instances for equality.

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

Tüm yol bileşenini güvenli olmayan veya ayrılmış karakterleri kendi onaltılı karakter temsillerinin için dönüştürür.Converts any unsafe or reserved characters in the path component to their hexadecimal character representations.

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

Bir dizeyi kaçan gösterimine dönüştürür.Converts a string to its escaped representation.

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

Bir dizeyi kaçan gösterimine dönüştürür.Converts a string to its escaped representation.

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

Bir URI dizesi kaçan gösterimine dönüştürür.Converts a URI string to its escaped representation.

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

Onaltılık bir ondalık değerini alır.Gets the decimal value of a hexadecimal digit.

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

Geçerli örneğin belirtilen kaçış için özel karakterleri kullanarak belirtilen bileşenler alır.Gets the specified components of the current instance using the specified escaping for special characters.

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

Karma kodu URI'sini alır.Gets the hash code for the URI.

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

Belirtilen kısmını alır bir Uri örneği.Gets the specified portion of a Uri instance.

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

Bu örneğin ömrü ilkesi denetimleri geçerli ömrü hizmet nesnesi alır.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)

Geçerli örneğini serileştirmek için gereken verileri döndürür.Returns the data needed to serialize the current instance.

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

Alır Type geçerli örneği.Gets the Type of the current instance.

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

Belirtilen bir karakterin onaltılık da eşdeğerine dönüştürür.Converts a specified character into its hexadecimal equivalent.

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

Bir karakteri belirtilen bir sayının onaltılık gösterimini karaktere dönüştürür.Converts a specified hexadecimal representation of a character to the character.

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

Bu örneğin ömrü ilkesi denetlemek için bir yaşam süresi hizmet nesnesi alır.Obtains a lifetime service object to control the lifetime policy for this instance.

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

Dosya sistemi adında geçersiz bir karakter olup olmadığını alır.Gets whether a character is invalid in a file system name.

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

Belirler olup olmadığını geçerli Uri örneği olan belirtilen temel Uri örneği.Determines whether the current Uri instance is a base of the specified Uri instance.

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

Belirtilen karakter kaçış olup olmadığını alır.Gets whether the specified character should be escaped.

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

Belirtilen bir karakterin geçerli bir onaltılık basamak olup olmadığını belirler.Determines whether a specified character is a valid hexadecimal digit.

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

Bir dizedeki bir karakterin onaltılık olup olmadığını belirler. kodlanmış.Determines whether a character in a string is hexadecimal encoded.

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

Belirtilen karakterin ayrılmış bir karakter olup olmadığını alır.Gets whether the specified character is a reserved character.

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

Dize bu oluşturmak için kullanılan olup olmadığını gösteren Uri doğru biçimlendirilmiş ve daha fazla kaçış için gerekli değildir.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)

Dize içeren bir URI oluşturmak deneyerek dize iyi biçimlendirilmiş olup olmadığını belirtir ve daha fazla kaçış dize gerektirmez sağlar.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)

İkisi arasındaki farkı belirler Uri örnekleri.Determines the difference between two Uri instances.

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

İkisi arasındaki farkı belirler Uri örnekleri.Determines the difference between two Uri instances.

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

Geçerli basit bir kopyasını oluşturur Object.Creates a shallow copy of the current Object.

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

Geçerli basit bir kopyasını oluşturur MarshalByRefObject nesne.Creates a shallow copy of the current MarshalByRefObject object.

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

Ayrıştırıyor emin olmak için URI geçerli örneğin geçerli bir URI için gerekli tüm parçaları içerir.Parses the URI of the current instance to ensure it contains all the parts required for a valid URI.

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

Belirtilen kurallı dize temsili alır Uri örneği.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)

Yeni bir oluşturur Uri belirtilen kullanarak String örneği ve bir 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)

Yeni bir oluşturur Uri belirtilen tabanda ile göreli String örnekleri.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)

Yeni bir oluşturur Uri belirtilen tabanda ile göreli Uri örnekleri.Creates a new Uri using the specified base and relative Uri instances.

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

Belirtilen dizeyi herhangi bir kaçış dizileri, atlanmamış gösterimi ile değiştirerek dönüştürür.Converts the specified string by replacing any escape sequences with their unescaped representation.

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

Bir dizeyi atlanmayan gösterimine dönüştürür.Converts a string to its unescaped representation.

İşleçler

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

İki olup olmadığını belirleyen Uri örnekleri aynı değere sahip olmalıdır.Determines whether two Uri instances have the same value.

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

İki olup olmadığını belirleyen Uri örnekleri aynı değere sahip değil.Determines whether two Uri instances do not have the same value.

Belirtik Arabirim Kullanımları

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

Geçerli örneğini serileştirmek için gereken verileri döndürür.Returns the data needed to serialize the current instance.

Şunlara uygulanır

Ayrıca bkz.