Uri Sınıf

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

Uri.cs

Tekdüzen kaynak tanımlayıcısının (URI) nesne gösterimini ve URI'nin bölümlerine kolay erişim sağlar.

public ref class Uri : ISpanFormattable, System::Runtime::Serialization::ISerializable

public class Uri : ISpanFormattable, System.Runtime.Serialization.ISerializable

type Uri = class
    interface ISpanFormattable
    interface IFormattable
    interface ISerializable

Public Class Uri
Implements ISerializable, ISpanFormattable

Devralma

Object

Uri

Uygulamalar

ISerializable IFormattable ISpanFormattable

Örnekler

Aşağıdaki örnek, Uri sınıfının bir örneğini oluşturur ve HttpClientile get isteği gerçekleştirmek için kullanır.

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

// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
HttpClient^ client = gcnew HttpClient;
HttpRequestMessage^ request = gcnew HttpRequestMessage(HttpMethod::Get, siteUri);
HttpResponseMessage^ response = client->Send(request);

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

// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
HttpClient client = new HttpClient();
HttpRequestMessage request = new HttpRequestMessage(HttpMethod.Get, siteUri);
HttpResponseMessage response = client.Send(request);

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

// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
use client = new HttpClient ()
use request = new HttpRequestMessage (HttpMethod.Get, siteUri)
use response = client.Send request

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

' HttpClient lifecycle management best practices:
' https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
Dim client As New HttpClient()
Dim request As New HttpRequestMessage(HttpMethod.Get, siteUri)
Dim response As HttpResponseMessage = client.Send(request)

Aşağıdaki kod parçacığı, sınıftaki çeşitli özelliklerin örnek değerlerini gösterir.

Uri uri = new Uri("https://user:password@www.contoso.com:80/Home/Index.htm?q1=v1&q2=v2#FragmentName");

Console.WriteLine($"AbsolutePath: {uri.AbsolutePath}");
Console.WriteLine($"AbsoluteUri: {uri.AbsoluteUri}");
Console.WriteLine($"DnsSafeHost: {uri.DnsSafeHost}");
Console.WriteLine($"Fragment: {uri.Fragment}");
Console.WriteLine($"Host: {uri.Host}");
Console.WriteLine($"HostNameType: {uri.HostNameType}");
Console.WriteLine($"IdnHost: {uri.IdnHost}");
Console.WriteLine($"IsAbsoluteUri: {uri.IsAbsoluteUri}");
Console.WriteLine($"IsDefaultPort: {uri.IsDefaultPort}");
Console.WriteLine($"IsFile: {uri.IsFile}");
Console.WriteLine($"IsLoopback: {uri.IsLoopback}");
Console.WriteLine($"IsUnc: {uri.IsUnc}");
Console.WriteLine($"LocalPath: {uri.LocalPath}");
Console.WriteLine($"OriginalString: {uri.OriginalString}");
Console.WriteLine($"PathAndQuery: {uri.PathAndQuery}");
Console.WriteLine($"Port: {uri.Port}");
Console.WriteLine($"Query: {uri.Query}");
Console.WriteLine($"Scheme: {uri.Scheme}");
Console.WriteLine($"Segments: {string.Join(", ", uri.Segments)}");
Console.WriteLine($"UserEscaped: {uri.UserEscaped}");
Console.WriteLine($"UserInfo: {uri.UserInfo}");

// AbsolutePath: /Home/Index.htm
// AbsoluteUri: https://user:password@www.contoso.com:80/Home/Index.htm?q1=v1&q2=v2#FragmentName
// DnsSafeHost: www.contoso.com
// Fragment: #FragmentName
// Host: www.contoso.com
// HostNameType: Dns
// IdnHost: www.contoso.com
// IsAbsoluteUri: True
// IsDefaultPort: False
// IsFile: False
// IsLoopback: False
// IsUnc: False
// LocalPath: /Home/Index.htm
// OriginalString: https://user:password@www.contoso.com:80/Home/Index.htm?q1=v1&q2=v2#FragmentName
// PathAndQuery: /Home/Index.htm?q1=v1&q2=v2
// Port: 80
// Query: ?q1=v1&q2=v2
// Scheme: https
// Segments: /, Home/, Index.htm
// UserEscaped: False
// UserInfo: user:password

let uri = Uri "https://user:password@www.contoso.com:80/Home/Index.htm?q1=v1&q2=v2#FragmentName"

printfn $"AbsolutePath: {uri.AbsolutePath}"
printfn $"AbsoluteUri: {uri.AbsoluteUri}"
printfn $"DnsSafeHost: {uri.DnsSafeHost}"
printfn $"Fragment: {uri.Fragment}"
printfn $"Host: {uri.Host}"
printfn $"HostNameType: {uri.HostNameType}"
printfn $"IdnHost: {uri.IdnHost}"
printfn $"IsAbsoluteUri: {uri.IsAbsoluteUri}"
printfn $"IsDefaultPort: {uri.IsDefaultPort}"
printfn $"IsFile: {uri.IsFile}"
printfn $"IsLoopback: {uri.IsLoopback}"
printfn $"IsUnc: {uri.IsUnc}"
printfn $"LocalPath: {uri.LocalPath}"
printfn $"OriginalString: {uri.OriginalString}"
printfn $"PathAndQuery: {uri.PathAndQuery}"
printfn $"Port: {uri.Port}"
printfn $"Query: {uri.Query}"
printfn $"Scheme: {uri.Scheme}"
printfn $"""Segments: {String.Join(", ", uri.Segments)}"""
printfn $"UserEscaped: {uri.UserEscaped}"
printfn $"UserInfo: {uri.UserInfo}"

// AbsolutePath: /Home/Index.htm
// AbsoluteUri: https://user:password@www.contoso.com:80/Home/Index.htm?q1=v1&q2=v2#FragmentName
// DnsSafeHost: www.contoso.com
// Fragment: #FragmentName
// Host: www.contoso.com
// HostNameType: Dns
// IdnHost: www.contoso.com
// IsAbsoluteUri: True
// IsDefaultPort: False
// IsFile: False
// IsLoopback: False
// IsUnc: False
// LocalPath: /Home/Index.htm
// OriginalString: https://user:password@www.contoso.com:80/Home/Index.htm?q1=v1&q2=v2#FragmentName
// PathAndQuery: /Home/Index.htm?q1=v1&q2=v2
// Port: 80
// Query: ?q1=v1&q2=v2
// Scheme: https
// Segments: /, Home/, Index.htm
// UserEscaped: False
// UserInfo: user:password

Açıklamalar

Bu API hakkında daha fazla bilgi için bkz. Uriiçin ek API açıklamaları .

Oluşturucular

Uri(SerializationInfo, StreamingContext)	Geçersiz. SerializationInfo ve StreamingContext sınıflarının belirtilen örneklerinden Uri sınıfının yeni bir örneğini başlatır.
Uri(String)	Belirtilen URI ile Uri sınıfının yeni bir örneğini başlatır.
Uri(String, Boolean)	Geçersiz. Belirtilen URI ile Uri sınıfının yeni bir örneğini başlatır ve karakter kaçışı açık denetimiyle.
Uri(String, UriCreationOptions)	Belirtilen URI ve ek UriCreationOptionsile Uri sınıfının yeni bir örneğini başlatır.
Uri(String, UriKind)	Belirtilen URI ile Uri sınıfının yeni bir örneğini başlatır. Bu oluşturucu, URI dizesinin göreli bir URI mi, mutlak URI mi yoksa belirsiz mi olduğunu belirtmenize olanak tanır.
Uri(Uri, String)	Belirtilen temel URI'yi ve göreli URI dizesini temel alarak Uri sınıfının yeni bir örneğini başlatır.
Uri(Uri, String, Boolean)	Geçersiz. Belirtilen temel ve göreli URI'leri temel alarak Uri sınıfının yeni bir örneğini başlatır ve karakter kaçışını açık bir şekilde denetler.
Uri(Uri, Uri)	Belirtilen temel Uri örneği ve göreli Uri örneği birleşimine göre Uri sınıfının yeni bir örneğini başlatır.

Alanlar

SchemeDelimiter	İletişim protokolü düzenini URI'nin adres bölümünden ayıran karakterleri belirtir. Bu alan salt okunur.
UriSchemeFile	URI'nin bir dosya işaretçisi olduğunu belirtir. Bu alan salt okunur.
UriSchemeFtp	URI'ye Dosya Aktarım Protokolü (FTP) aracılığıyla erişildiğini belirtir. Bu alan salt okunur.
UriSchemeFtps	URI'ye Dosya Aktarım Protokolü Güvenli (FTPS) aracılığıyla erişildiğini belirtir. Bu alan salt okunur.
UriSchemeGopher	URI'ye Gopher protokolü aracılığıyla erişildiğini belirtir. Bu alan salt okunur.
UriSchemeHttp	URI'ye Köprü Metni Aktarım Protokolü (HTTP) aracılığıyla erişildiğini belirtir. Bu alan salt okunur.
UriSchemeHttps	URI'ye Güvenli Köprü Metni Aktarım Protokolü (HTTPS) aracılığıyla erişildiğini belirtir. Bu alan salt okunur.
UriSchemeMailto	URI'nin bir e-posta adresi olduğunu ve Basit Posta Aktarım Protokolü (SMTP) aracılığıyla erişildiğini belirtir. Bu alan salt okunur.
UriSchemeNetPipe	URI'ye Windows Communication Foundation (WCF) tarafından kullanılan NetPipe şeması aracılığıyla erişildiğini belirtir. Bu alan salt okunur.
UriSchemeNetTcp	URI'ye Windows Communication Foundation (WCF) tarafından kullanılan NetTcp şeması aracılığıyla erişildiğini belirtir. Bu alan salt okunur.
UriSchemeNews	URI'nin bir İnternet haber grubu olduğunu ve Ağ Haber Aktarım Protokolü (NNTP) üzerinden erişildiğini belirtir. Bu alan salt okunur.
UriSchemeNntp	URI'nin bir İnternet haber grubu olduğunu ve Ağ Haber Aktarım Protokolü (NNTP) üzerinden erişildiğini belirtir. Bu alan salt okunur.
UriSchemeSftp	URI'ye SSH Dosya Aktarım Protokolü (SFTP) aracılığıyla erişildiğini belirtir. Bu alan salt okunur.
UriSchemeSsh	URI'ye Güvenli Yuva Kabuğu protokolü (SSH) aracılığıyla erişildiğini belirtir. Bu alan salt okunur.
UriSchemeTelnet	URI'ye Telnet protokolü aracılığıyla erişildiğini belirtir. Bu alan salt okunur.
UriSchemeWs	URI'ye WebSocket protokolü (WS) üzerinden erişildiğini belirtir. Bu alan salt okunur.
UriSchemeWss	URI'ye WebSocket Güvenli protokolü (WSS) üzerinden erişildiğini belirtir. Bu alan salt okunur.

Özellikler

AbsolutePath	URI'nin mutlak yolunu alır.
AbsoluteUri	Mutlak URI'yi alır.
Authority	Etki Alanı Adı Sistemi (DNS) ana bilgisayar adını veya IP adresini ve bir sunucunun bağlantı noktası numarasını alır.
DnsSafeHost	Gerekirse, manzarası kaldırıldıktan sonra DNS çözümlemesi için güvenli olan bir ana bilgisayar adı alır.
Fragment	Boş değilse baştaki '#' karakteri de dahil olmak üzere kaçış URI parçasını alır.
Host	Bu örneğin konak bileşenini alır.
HostNameType	URI'de belirtilen konak adının türünü alır.
IdnHost	Punycode'u uygun şekilde kullanarak konağın RFC 3490 uyumlu Uluslararası Etki Alanı Adını alır. Gerekirse, bu dizenin manzarası kaldırıldıktan sonra DNS çözümlemesi için kullanılması güvenlidir.
IsAbsoluteUri	Uri örneğinin mutlak olup olmadığını gösteren bir değer alır.
IsDefaultPort	URI'nin bağlantı noktası değerinin bu düzen için varsayılan olup olmadığını gösteren bir değer alır.
IsFile	Belirtilen Uri dosya URI'sinin olup olmadığını gösteren bir değer alır.
IsLoopback	Belirtilen Uri yerel konağa başvurup başvurmadığını gösteren bir değer alır.
IsUnc	Belirtilen Uri evrensel adlandırma kuralı (UNC) yolu olup olmadığını gösteren bir değer alır.
LocalPath	Dosya adının yerel işletim sistemi gösterimini alır.
OriginalString	Uri oluşturucusunun geçirildiği özgün URI dizesini alır.
PathAndQuery	AbsolutePath ve Query özelliklerini soru işaretiyle (?) ayırarak alır.
Port	Bu URI'nin bağlantı noktası numarasını alır.
Query	Boş değilse baştaki '?' karakteri de dahil olmak üzere belirtilen URI'ye dahil olan tüm sorgu bilgilerini alır.
Scheme	Bu URI için şema adını alır.
Segments	Belirtilen URI'yi oluşturan yol kesimlerini içeren bir dizi alır.
UserEscaped	URI dizesinin Uri örneği oluşturulmadan önce tamamen kaçış yapılıp yapılmadığını gösteren bir değer alır.
UserInfo	Belirtilen URI ile ilişkili kullanıcı adını, parolayı veya kullanıcıya özgü diğer bilgileri alır.

Yöntemler

Canonicalize()	Geçersiz. dahili olarak depolanan URI'yi kurallı forma dönüştürür.
CheckHostName(String)	Belirtilen ana bilgisayar adının geçerli bir DNS adı olup olmadığını belirler.
CheckSchemeName(String)	Belirtilen düzen adının geçerli olup olmadığını belirler.
CheckSecurity()	Geçersiz. Bu yöntemi çağırmanın hiçbir etkisi yoktur.
Compare(Uri, Uri, UriComponents, UriFormat, StringComparison)	Belirtilen karşılaştırma kurallarını kullanarak iki URI'nin belirtilen bölümlerini karşılaştırır.
Equals(Object)	Eşitlik için iki Uri örneğini karşılaştırır.
Escape()	Geçersiz. Yol bileşenindeki güvenli olmayan veya ayrılmış karakterleri onaltılık karakter gösterimlerine dönüştürür.
EscapeDataString(String)	Bir dizeyi kaçış gösterimine dönüştürür.
EscapeString(String)	Geçersiz. Bir dizeyi kaçış gösterimine dönüştürür.
EscapeUriString(String)	Geçersiz. URI dizesini kaçış gösterimine dönüştürür.
FromHex(Char)	Onaltılık bir rakamın ondalık değerini alır.
GetComponents(UriComponents, UriFormat)	Özel karakterler için belirtilen kaçışı kullanarak geçerli örneğin belirtilen bileşenlerini alır.
GetHashCode()	URI için karma kodu alır.
GetLeftPart(UriPartial)	Uri örneğinin belirtilen bölümünü alır.
GetObjectData(SerializationInfo, StreamingContext)	Geçerli örneği seri hale getirmek için gereken verileri döndürür.
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
HexEscape(Char)	Belirtilen karakteri onaltılık eşdeğerine dönüştürür.
HexUnescape(String, Int32)	Bir karakterin belirtilen onaltılık gösterimini karaktere dönüştürür.
IsBadFileSystemCharacter(Char)	Geçersiz. Dosya sistemi adında bir karakterin geçersiz olup olmadığını gösterir.
IsBaseOf(Uri)	Geçerli Uri örneğinin belirtilen Uri örneğinin temeli olup olmadığını belirler.
IsExcludedCharacter(Char)	Geçersiz. Belirtilen karakterin kaçış yapılıp yapılmayacağını belirler.
IsHexDigit(Char)	Belirtilen karakterin geçerli bir onaltılık basamak olup olmadığını belirler.
IsHexEncoding(String, Int32)	Dizedeki bir karakterin onaltılık kodlanmış olup olmadığını belirler.
IsReservedCharacter(Char)	Geçersiz. Belirtilen karakterin ayrılmış karakter olup olmadığını belirler.
IsWellFormedOriginalString()	Bu Uri oluşturmak için kullanılan dizenin iyi biçimlendirilmiş olup olmadığını ve daha fazla kaçış gerektirmediğini gösterir.
IsWellFormedUriString(String, UriKind)	Dize ile bir URI oluşturmayı deneyerek dizenin iyi biçimlendirilip biçimlendirilmediğini gösterir ve dizenin daha fazla kaçış gerektirmemesini sağlar.
MakeRelative(Uri)	Geçersiz. İki Uri örneği arasındaki farkı belirler.
MakeRelativeUri(Uri)	İki Uri örneği arasındaki farkı belirler.
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
Parse()	Geçersiz. Geçerli bir URI için gereken tüm bölümleri içerdiğinden emin olmak için geçerli örneğin URI'sini ayrıştırıyor.
ToString()	Belirtilen Uri örneği için kurallı dize gösterimini alır.
TryCreate(String, UriCreationOptions, Uri)	Belirtilen String örneğini kullanarak yeni bir Uri oluşturur ve UriCreationOptions.
TryCreate(String, UriKind, Uri)	Belirtilen String örneğini ve UriKindkullanarak yeni bir Uri oluşturur.
TryCreate(Uri, String, Uri)	Belirtilen temel ve göreli String örneklerini kullanarak yeni bir Uri oluşturur.
TryCreate(Uri, Uri, Uri)	Belirtilen temel ve göreli Uri örneklerini kullanarak yeni bir Uri oluşturur.
TryFormat(Span<Char>, Int32)	Uri örneği için kurallı dize gösterimini belirtilen yayılma alanına biçimlendirmeye çalışır.
Unescape(String)	Geçersiz. Herhangi bir kaçış dizisini, sıralanmamış gösterimleriyle değiştirerek belirtilen dizeyi dönüştürür.
UnescapeDataString(String)	Bir dizeyi manzarasız gösterimine dönüştürür.

İşleçler

Equality(Uri, Uri)	İki Uri örneğin aynı değere sahip olup olmadığını belirler.
Inequality(Uri, Uri)	İki Uri örneğin aynı değere sahip olup olmadığını belirler.

Belirtik Arabirim Kullanımları

IFormattable.ToString(String, IFormatProvider)	Belirtilen biçimi kullanarak geçerli örneğin değerini biçimlendirin.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Geçerli örneği seri hale getirmek için gereken verileri döndürür.
ISpanFormattable.TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)	Geçerli örneğin değerini sağlanan karakter aralığına biçimlendirmeye çalışır.

İş Parçacığı Güvenliği

Uri tüm üyeleri iş parçacığı açısından güvenlidir ve birden çok iş parçacığından eşzamanlı olarak kullanılabilir.

Ayrıca bkz.

• IdnElement
• IriParsingElement
• UriSection
• DnsSafeHost
• MakeRelative(Uri)
• IsWellFormedOriginalString()
• UriBuilder
• Sürüm 2.0'da System.Uri ad alanında yapılan değişiklikleri
• System.UriSystem.Uri'da uluslararası kaynak tanımlayıcı desteği
• .NET Framework'nde Ağ Programlamayı