Uri Oluşturucular

Tanım

Uri sınıfının yeni bir örneğini başlatır.

Aşırı Yüklemeler

Name Description
Uri(String)

Belirtilen URI ile sınıfının yeni bir örneğini Uri başlatır.

Uri(SerializationInfo, StreamingContext)
Geçersiz.

ve Uri sınıflarının SerializationInfo belirtilen örneklerinden StreamingContext sınıfının yeni bir örneğini başlatır.

Uri(String, Boolean)
Geçersiz.
Geçersiz.
Geçersiz.
Geçersiz.

Belirtilen URI ile sınıfın Uri yeni bir örneğini başlatır ve karakter kaçışının açık denetimiyle.

Uri(String, UriCreationOptions)

Belirtilen URI ve ek Uriile sınıfının yeni bir örneğini UriCreationOptions başlatır.

Uri(String, UriKind)

Belirtilen URI ile sınıfının yeni bir örneğini Uri 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 Uri temel alarak sınıfının yeni bir örneğini başlatır.

Uri(Uri, Uri)

Belirtilen bir temel Uri örneğin ve göreli Uri örneğin birleşimine göre sınıfının yeni bir örneğini Uri başlatır.

Uri(Uri, String, Boolean)
Geçersiz.
Geçersiz.
Geçersiz.
Geçersiz.

Belirtilen temel ve göreli URI'leri temel alarak sınıfın Uri yeni bir örneğini başlatır ve karakter kaçışını açık bir şekilde denetler.

Uri(String)

Kaynak:
Uri.cs
Kaynak:
Uri.cs
Kaynak:
Uri.cs
Kaynak:
Uri.cs
Kaynak:
Uri.cs

Belirtilen URI ile sınıfının yeni bir örneğini Uri başlatır.

public:
 Uri(System::String ^ uriString);
public Uri(string uriString);
new Uri : string -> Uri
Public Sub New (uriString As String)

Parametreler

uriString
String

Örnek tarafından Uri temsil edilecek kaynağı tanımlayan bir dize.

Özel durumlar

uriString, null'e eşittir.

Not: Windows Store uygulamaları için .NET veya Portable Sınıf Kitaplığı bunun yerine temel sınıf özel durumunu (FormatException) yakalayın.

uriString boş.

-veya-

içinde uriString belirtilen düzen doğru biçimlendirilmemiş. Bkz. CheckSchemeName(String).

-veya-

uriString çok fazla eğik çizgi içeriyor.

-veya-

içinde belirtilen uriString parola, ana bilgisayar adı, dosya adı veya kullanıcı adı geçerli değil.

-veya-

içinde uriString belirtilen konak veya yetkili adı ters eğik çizgilerle sonlandırılır.

-veya-

içinde uriString belirtilen bağlantı noktası numarası geçerli değil veya ayrıştırılamıyor.

-veya-

Uzunluğu uriString 65519 karakteri aşıyor (yalnızca.NET 9 ve önceki sürümler).

-veya-

içinde uriString belirtilen düzenin uzunluğu 1023 karakteri aşıyor.

-veya-

içinde uriStringgeçersiz bir karakter dizisi var.

-veya-

içinde uriString belirtilen MS-DOS yolu c:\\ ile başlamaz.

Örnekler

Aşağıdaki örnek URI'sine Urisahip bir http://www.contoso.com/ örnek oluşturur.

Uri myUri = new Uri("http://www.contoso.com/");
let myUri = Uri "http://www.contoso.com/"
Dim myUri As New Uri("http://www.contoso.com/")

Açıklamalar

Bu oluşturucu bir URI dizesinden bir Uri örnek oluşturur. URI'yi ayrıştırarak kurallı biçimde yerleştirir ve gerekli kaçış kodlamalarını yapar.

Bu oluşturucu, öğesinin erişilebilir bir kaynağa başvurduğundan Uri emin değildir.

uriString bir IPv6 adresini temsil ediyorsa, köşeli ayraç içine alınmalıdır, örneğin, "http://[2607:f8b0:400d:c06::69]".

Bu oluşturucu, parametresinin string mutlak bir URI'ye başvurduğunu ve ile oluşturucunun Uri çağrılmasıyla UriKindAbsoluteeşdeğer olduğunu varsayar. Oluşturucuya string geçirilen parametre göreli bir URI ise, bu oluşturucu bir UriFormatExceptionoluşturur.

Şunlara uygulanır

Uri(SerializationInfo, StreamingContext)

Kaynak:
Uri.cs
Kaynak:
Uri.cs
Kaynak:
Uri.cs
Kaynak:
Uri.cs
Kaynak:
Uri.cs

Dikkat

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

ve Uri sınıflarının SerializationInfo belirtilen örneklerinden StreamingContext sınıfının yeni bir örneğini başlatır.

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

Parametreler

serializationInfo
SerializationInfo

Yeni Uri örneği seri hale getirmek için gereken bilgiler.

streamingContext
StreamingContext

Yeni Uri örnekle ilişkili serileştirilmiş akışın kaynağı.

Öznitelikler

Özel durumlar

serializationInfo parametresi bir null URI içerir.

serializationInfo parametresi boş bir URI içeriyor.

-veya-

Belirtilen düzen doğru biçimlendirilmemiş. Bkz. CheckSchemeName(String).

-veya-

URI çok fazla eğik çizgi içeriyor.

-veya-

URI'de belirtilen parola, ana bilgisayar adı, dosya adı veya kullanıcı adı geçerli değil.

-veya-

URI'de belirtilen konak veya yetkili adı ters eğik çizgilerle sonlandırılır.

-veya-

URI'de belirtilen bağlantı noktası numarası geçerli değil veya ayrıştırılamıyor.

-veya-

URI uzunluğu 65519 karakteri aşıyor (yalnızca.NET 9 ve önceki sürümler).

-veya-

URI'de belirtilen düzenin uzunluğu 1023 karakteri aşıyor.

-veya-

URI'de geçersiz bir karakter dizisi var.

-veya-

URI'de belirtilen MS-DOS yolu c:\\ ile başlamaz.

Açıklamalar

Bu oluşturucu sınıfı için arabirimini ISerializable uygularUri.

Ayrıca bkz.

Şunlara uygulanır

Uri(String, Boolean)

Kaynak:
Uri.cs
Kaynak:
Uri.cs
Kaynak:
Uri.cs
Kaynak:
Uri.cs
Kaynak:
Uri.cs

Dikkat

This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(string) instead.

Dikkat

This constructor has been deprecated. Use Uri(string) instead.

Dikkat

The constructor has been deprecated. Please use new Uri(string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202

Dikkat

The constructor has been deprecated. Please use new Uri(string). The dontEscape parameter is deprecated and is always false. http://go.microsoft.com/fwlink/?linkid=14202

Belirtilen URI ile sınıfın Uri yeni bir örneğini başlatır ve karakter kaçışının açık denetimiyle.

public:
 Uri(System::String ^ uriString, bool dontEscape);
[System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(string) instead.")]
public Uri(string uriString, bool dontEscape);
[System.Obsolete("This constructor has been deprecated. Use Uri(string) instead.")]
public Uri(string uriString, bool dontEscape);
[System.Obsolete("The constructor has been deprecated. Please use new Uri(string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")]
public Uri(string uriString, bool dontEscape);
[System.Obsolete("The constructor has been deprecated. Please use new Uri(string). The dontEscape parameter is deprecated and is always false. http://go.microsoft.com/fwlink/?linkid=14202")]
public Uri(string uriString, bool dontEscape);
public Uri(string uriString, bool dontEscape);
[<System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(string) instead.")>]
new Uri : string * bool -> Uri
[<System.Obsolete("This constructor has been deprecated. Use Uri(string) instead.")>]
new Uri : string * bool -> Uri
[<System.Obsolete("The constructor has been deprecated. Please use new Uri(string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")>]
new Uri : string * bool -> Uri
[<System.Obsolete("The constructor has been deprecated. Please use new Uri(string). The dontEscape parameter is deprecated and is always false. http://go.microsoft.com/fwlink/?linkid=14202")>]
new Uri : string * bool -> Uri
new Uri : string * bool -> Uri
Public Sub New (uriString As String, dontEscape As Boolean)

Parametreler

uriString
String

Örnek tarafından Uri temsil edilecek kaynağı tanımlayan bir dize. Dize biçimindeki bir IPv6 adresinin köşeli ayraç içine alınması gerektiğini unutmayın. Örneğin, "http://[2607:f8b0:400d:c06::69]".

dontEscape
Boolean

true tamamen kaçılırsa uriString ; değilse, false.

Öznitelikler

Özel durumlar

uriString, null'e eşittir.

uriString boş veya yalnızca boşluk içeriyor.

-veya-

içinde uriString belirtilen düzen geçerli değil.

-veya-

uriString çok fazla eğik çizgi içeriyor.

-veya-

içinde belirtilen uriString parola, ana bilgisayar adı, dosya adı veya kullanıcı adı geçerli değil.

-veya-

içinde uriString belirtilen konak veya yetkili adı ters eğik çizgilerle sonlandırılır.

-veya-

içinde uriString belirtilen bağlantı noktası numarası geçerli değil veya ayrıştırılamıyor.

-veya-

Uzunluğu uriString 65519 karakteri aşıyor (yalnızca.NET 9 ve önceki sürümler).

-veya-

içinde uriString belirtilen düzenin uzunluğu 1023 karakteri aşıyor.

-veya-

içinde uriStringgeçersiz bir karakter dizisi var.

-veya-

içinde uriString belirtilen MS-DOS yolu c:\\ ile başlamaz.

Açıklamalar

Bu oluşturucu bir URI dizesinden bir Uri örnek oluşturur. URI'yi ayrıştırıp kurallı biçimde yerleştirir.

parametresi, dontEscape ayrılmış karakterlerin kaçış dizilerine çevrilip çevrilmeyeceğini denetler. Bu parametre yalnızca true URI'deki tüm ayrılmış karakterlerin kaçıldığından eminseniz olarak ayarlanmalıdır. Değerin true tamamen kaçılmayan bir URI için olarak ayarlanması beklenmeyen davranışlara neden olabilir. Bu parametreyi her zaman olarak falseayarlamanız kesinlikle önerilir.

olarak ayarlanırsa dontEscapefalse, oluşturucu tüm yüzde oluşumlarının (%) geçerli bir kaçış dizisinin ardından geldiğini denetleyerek ayrılmış karakterlerden kurtulur. Bir yüzdeyi izleyen karakter dizisi geçerli değilse, yüzde değeri %25ile değiştirilir.

Bu oluşturucu, öğesinin erişilebilir bir kaynağa başvurduğundan Uri emin değildir.

Şunlara uygulanır

Uri(String, UriCreationOptions)

Kaynak:
Uri.cs
Kaynak:
Uri.cs
Kaynak:
Uri.cs
Kaynak:
Uri.cs
Kaynak:
Uri.cs

Belirtilen URI ve ek Uriile sınıfının yeni bir örneğini UriCreationOptions başlatır.

public:
 Uri(System::String ^ uriString, UriCreationOptions % creationOptions);
public Uri(string uriString, in UriCreationOptions creationOptions);
new Uri : string * UriCreationOptions -> Uri
Public Sub New (uriString As String, ByRef creationOptions As UriCreationOptions)

Parametreler

uriString
String

Örnek tarafından Uri temsil edilecek kaynağı tanımlayan bir dize.

creationOptions
UriCreationOptions

öğesinin nasıl oluşturulduğunu Uri ve nasıl davranacağını denetleyebilen seçenekler.

Şunlara uygulanır

Uri(String, UriKind)

Kaynak:
Uri.cs
Kaynak:
Uri.cs
Kaynak:
Uri.cs
Kaynak:
Uri.cs
Kaynak:
Uri.cs

Belirtilen URI ile sınıfının yeni bir örneğini Uri 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.

public:
 Uri(System::String ^ uriString, UriKind uriKind);
public Uri(string uriString, UriKind uriKind);
new Uri : string * UriKind -> Uri
Public Sub New (uriString As String, uriKind As UriKind)

Parametreler

uriString
String

Örnek tarafından Uri temsil edilecek kaynağı tanımlayan bir dize.

uriKind
UriKind

URI dizesinin göreli bir URI mi, mutlak URI mi yoksa belirsiz mi olduğunu belirtir.

Özel durumlar

uriKind geçersiz.

uriString, null'e eşittir.

Not: Windows Store uygulamaları için .NET veya Portable Sınıf Kitaplığı bunun yerine temel sınıf özel durumunu (FormatException) yakalayın.

uriString göreli bir URI içerir ve uriKind şeklindedir Absolute.

veya

uriString mutlak bir URI içerir ve uriKind şeklindedir Relative.

veya

uriString boş.

-veya-

içinde uriString belirtilen düzen doğru biçimlendirilmemiş. Bkz. CheckSchemeName(String).

-veya-

uriString çok fazla eğik çizgi içeriyor.

-veya-

içinde belirtilen uriString parola, ana bilgisayar adı, dosya adı veya kullanıcı adı geçerli değil.

-veya-

içinde uriString belirtilen konak veya yetkili adı ters eğik çizgilerle sonlandırılır.

-veya-

içinde uriString belirtilen bağlantı noktası numarası geçerli değil veya ayrıştırılamıyor.

-veya-

Uzunluğu uriString 65519 karakteri aşıyor (yalnızca.NET 9 ve önceki sürümler).

-veya-

içinde uriString belirtilen düzenin uzunluğu 1023 karakteri aşıyor.

-veya-

içinde uriStringgeçersiz bir karakter dizisi var.

-veya-

içinde uriString belirtilen MS-DOS yolu c:\\ ile başlamaz.

Açıklamalar

Göreli ve mutlak URI'ler, biçimlerinde farklı kısıtlamalara sahiptir. Örneğin, göreli URI bir şema veya yetkili gerektirmez. içinde uriKind belirttiğiniz değer, içinde uriStringgeçirilen URI türüyle eşleşmelidir. Ancak belirtilirse RelativeOrAbsolute , URI dizesi göreli veya mutlak olabilir.

için uriString, dize biçimindeki bir IPv6 adresi köşeli ayraç içine alınmalıdır; örneğin, "http://[2607:f8b0:400d:c06::69]".

Şunlara uygulanır

Uri(Uri, String)

Kaynak:
Uri.cs
Kaynak:
Uri.cs
Kaynak:
Uri.cs
Kaynak:
Uri.cs
Kaynak:
Uri.cs

Belirtilen temel URI'yi ve göreli URI dizesini Uri temel alarak sınıfının yeni bir örneğini başlatır.

public:
 Uri(Uri ^ baseUri, System::String ^ relativeUri);
public Uri(Uri baseUri, string relativeUri);
public Uri(Uri baseUri, string? relativeUri);
new Uri : Uri * string -> Uri
Public Sub New (baseUri As Uri, relativeUri As String)

Parametreler

baseUri
Uri

Temel URI.

relativeUri
String

Temel URI'ye eklenecek göreli URI.

Özel durumlar

baseUri, null'e eşittir.

baseUri mutlak Uri bir örnek değildir.

birleştirilerek baseUrirelativeUri oluşturulan URI boştur veya yalnızca boşluklar içerir.

-veya-

URI'de belirtilen düzen birleştirilerek baseUri oluşturulur ve relativeUri geçerli değildir.

-veya-

Birleştirilerek baseUri oluşturulan ve relativeUri çok fazla eğik çizgi içeren URI.

-veya-

Birleştirilerek baseUrirelativeUri oluşturulan ve geçerli olmayan URI'de belirtilen parola, ana bilgisayar adı, dosya adı veya kullanıcı adı.

-veya-

URI'de belirtilen konak veya yetkili adı birleştirilerek baseUri oluşturulur ve relativeUri ters eğik çizgilerle sonlandırılır.

-veya-

Birleştirilerek baseUrirelativeUri oluşturulan URI'de belirtilen bağlantı noktası numarası geçerli değil veya ayrıştırılamıyor.

-veya-

Birleştirilerek baseUrirelativeUri oluşturulan URI'nin uzunluğu 65519 karakteri aşıyor (yalnızca.NET 9 ve önceki sürümler).

-veya-

Birleştirilerek baseUrirelativeUri oluşturulan URI'de belirtilen düzenin uzunluğu 1023 karakteri aşıyor.

-veya-

ve baseUribirleştirilerek relativeUri oluşturulan URI'de geçersiz bir karakter dizisi vardır.

-veya-

içinde baseUri belirtilen MS-DOS yolu c:\\ ile başlamaz.

Örnekler

Aşağıdaki örnek, göreli URI'leri Uri birleştirerek ve http://www.contoso.com mutlak URI'yi catalog/shownew.htmoluşturarak sınıfının yeni bir örneğini http://www.contoso.com/catalog/shownew.htm oluşturur.

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

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

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

Console.WriteLine(myUri.ToString())

Açıklamalar

Bu oluşturucu ve Uriöğesini birleştirerek baseUri bir relativeUri örnek oluşturur. Mutlak bir URI ise relativeUri (bir düzen, konak adı ve isteğe bağlı olarak bir bağlantı noktası numarası içeren), Uri örnek yalnızca relativeUrikullanılarak oluşturulur.

baseUri göreli bölümleri varsa (gibi/api), göreli bölümü, yapılandırılmış /api/içinde korunacaksa, göreli parça baseUri eğik çizgiyle (gibiUri) sonlandırılmalıdır.

Ayrıca eğik çizgi ile başlıyorsa relativeUri , baseUri

Bu oluşturucu, öğesinin erişilebilir bir kaynağa başvurduğundan Uri emin değildir.

Şunlara uygulanır

Uri(Uri, Uri)

Kaynak:
Uri.cs
Kaynak:
Uri.cs
Kaynak:
Uri.cs
Kaynak:
Uri.cs
Kaynak:
Uri.cs

Belirtilen bir temel Uri örneğin ve göreli Uri örneğin birleşimine göre sınıfının yeni bir örneğini Uri başlatır.

public:
 Uri(Uri ^ baseUri, Uri ^ relativeUri);
public Uri(Uri baseUri, Uri relativeUri);
new Uri : Uri * Uri -> Uri
Public Sub New (baseUri As Uri, relativeUri As Uri)

Parametreler

baseUri
Uri

Yeni Uri örneğin temeli olan mutlakUri.

relativeUri
Uri

ile Uribirleştirilen göreli baseUri örnek.

Özel durumlar

baseUri mutlak Uri bir örnek değildir.

baseUri, null'e eşittir.

baseUri mutlak Uri bir örnek değildir.

Not: Windows Store uygulamaları için .NET veya Portable Sınıf Kitaplığı bunun yerine temel sınıf özel durumunu (FormatException) yakalayın.

birleştirilerek baseUrirelativeUri oluşturulan URI boştur veya yalnızca boşluklar içerir.

-veya-

URI'de belirtilen düzen birleştirilerek baseUri oluşturulur ve relativeUri geçerli değildir.

-veya-

Birleştirilerek baseUri oluşturulan ve relativeUri çok fazla eğik çizgi içeren URI.

-veya-

Birleştirilerek baseUrirelativeUri oluşturulan ve geçerli olmayan URI'de belirtilen parola, ana bilgisayar adı, dosya adı veya kullanıcı adı.

-veya-

URI'de belirtilen konak veya yetkili adı birleştirilerek baseUri oluşturulur ve relativeUri ters eğik çizgilerle sonlandırılır.

-veya-

Birleştirilerek baseUrirelativeUri oluşturulan URI'de belirtilen bağlantı noktası numarası geçerli değil veya ayrıştırılamıyor.

-veya-

Birleştirilerek baseUrirelativeUri oluşturulan URI'nin uzunluğu 65519 karakteri aşıyor (yalnızca.NET 9 ve önceki sürümler).

-veya-

Birleştirilerek baseUrirelativeUri oluşturulan URI'de belirtilen düzenin uzunluğu 1023 karakteri aşıyor.

-veya-

ve baseUribirleştirilerek relativeUri oluşturulan URI'de geçersiz bir karakter dizisi vardır.

-veya-

içinde baseUri belirtilen MS-DOS yolu c:\\ ile başlamaz.

Örnekler

Bu örnek, mutlak Uri bir örneği ve absoluteUrigöreli Uri örneği relativeUrioluşturur. Ardından bu iki örnekten yeni Uri bir örneği combinedUrioluşturulur.

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

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

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

// Create a new Uri from an absolute Uri and a relative Uri.
Uri combinedUri = new Uri(absoluteUri, relativeUri);
Console.WriteLine(combinedUri.AbsoluteUri);
// Create an absolute Uri from a string.
let absoluteUri = Uri "http://www.contoso.com/"

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

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

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

End Sub

Açıklamalar

Bu oluşturucu, Urigöreli bir örnek olan mutlak Uri örneği ile birleştirerek yeni baseUri bir örnek UrirelativeUri oluşturur. Mutlak bir örnekse relativeUri (şema, konak adı ve isteğe bağlı olarak bir bağlantı noktası numarası içeren), Uri örnek yalnızca Urikullanılarak oluşturulur.relativeUri

baseUri göreli bölümleri varsa (gibi/api), göreli bölümü, yapılandırılmış /api/içinde korunacaksa, göreli parça baseUri eğik çizgiyle (gibiUri) sonlandırılmalıdır.

Ayrıca eğik çizgiyle başlıyorsa relativeUri , öğesinin baseUriherhangi bir göreli kısmının yerini alır.

Bu oluşturucu, öğesinin erişilebilir bir kaynağa başvurduğundan Uri emin değildir.

Şunlara uygulanır

Uri(Uri, String, Boolean)

Kaynak:
Uri.cs
Kaynak:
Uri.cs
Kaynak:
Uri.cs
Kaynak:
Uri.cs
Kaynak:
Uri.cs

Dikkat

This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(Uri, string) instead.

Dikkat

This constructor has been deprecated. Use Uri(Uri, string) instead.

Dikkat

The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202

Dikkat

The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. http://go.microsoft.com/fwlink/?linkid=14202

Belirtilen temel ve göreli URI'leri temel alarak sınıfın Uri yeni bir örneğini başlatır ve karakter kaçışını açık bir şekilde denetler.

public:
 Uri(Uri ^ baseUri, System::String ^ relativeUri, bool dontEscape);
[System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(Uri, string) instead.")]
public Uri(Uri baseUri, string? relativeUri, bool dontEscape);
[System.Obsolete("This constructor has been deprecated. Use Uri(Uri, string) instead.")]
public Uri(Uri baseUri, string? relativeUri, bool dontEscape);
[System.Obsolete("The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")]
public Uri(Uri baseUri, string? relativeUri, bool dontEscape);
[System.Obsolete("The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. http://go.microsoft.com/fwlink/?linkid=14202")]
public Uri(Uri baseUri, string relativeUri, bool dontEscape);
public Uri(Uri baseUri, string relativeUri, bool dontEscape);
[System.Obsolete("The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")]
public Uri(Uri baseUri, string relativeUri, bool dontEscape);
[<System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(Uri, string) instead.")>]
new Uri : Uri * string * bool -> Uri
[<System.Obsolete("This constructor has been deprecated. Use Uri(Uri, string) instead.")>]
new Uri : Uri * string * bool -> Uri
[<System.Obsolete("The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")>]
new Uri : Uri * string * bool -> Uri
[<System.Obsolete("The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. http://go.microsoft.com/fwlink/?linkid=14202")>]
new Uri : Uri * string * bool -> Uri
new Uri : Uri * string * bool -> Uri
Public Sub New (baseUri As Uri, relativeUri As String, dontEscape As Boolean)

Parametreler

baseUri
Uri

Temel URI.

relativeUri
String

Temel URI'ye eklenecek göreli URI.

dontEscape
Boolean

trueve tamamen kaçılırsabaseUri; değilse, relativeUri.false

Öznitelikler

Özel durumlar

baseUri, null'e eşittir.

baseUri mutlak Uri bir örnek değildir.

birleştirilerek baseUrirelativeUri oluşturulan URI boştur veya yalnızca boşluklar içerir.

-veya-

URI'de belirtilen düzen birleştirilerek baseUri oluşturulur ve relativeUri geçerli değildir.

-veya-

Birleştirilerek baseUri oluşturulan ve relativeUri çok fazla eğik çizgi içeren URI.

-veya-

Birleştirilerek baseUrirelativeUri oluşturulan ve geçerli olmayan URI'de belirtilen parola, ana bilgisayar adı, dosya adı veya kullanıcı adı.

-veya-

URI'de belirtilen konak veya yetkili adı birleştirilerek baseUri oluşturulur ve relativeUri ters eğik çizgilerle sonlandırılır.

-veya-

Birleştirilerek baseUrirelativeUri oluşturulan URI'de belirtilen bağlantı noktası numarası geçerli değil veya ayrıştırılamıyor.

-veya-

Birleştirilerek baseUrirelativeUri oluşturulan URI'nin uzunluğu 65519 karakteri aşıyor (yalnızca.NET 9 ve önceki sürümler).

-veya-

Birleştirilerek baseUrirelativeUri oluşturulan URI'de belirtilen düzenin uzunluğu 1023 karakteri aşıyor.

-veya-

ve baseUribirleştirilerek relativeUri oluşturulan URI'de geçersiz bir karakter dizisi vardır.

-veya-

içinde baseUri belirtilen MS-DOS yolu c:\\ ile başlamaz.

Açıklamalar

Bu oluşturucu ve Uribirleştirerek baseUri bir relativeUri örnek oluşturur. geçirilen relativeUri URI mutlak bir URI ise (bir düzen, ana bilgisayar adı ve isteğe bağlı olarak bir bağlantı noktası numarası içerir), Uri örnek yalnızca relativeUrikullanılarak oluşturulur.

parametresi, dontEscape ayrılmış karakterlerin kaçış dizilerine çevrilip çevrilmeyeceğini denetler. Bu parametre yalnızca true URI'deki tüm ayrılmış karakterlerin kaçıldığından eminseniz olarak ayarlanmalıdır. Değerin true tamamen kaçılmayan bir URI için olarak ayarlanması beklenmeyen davranışlara neden olabilir. Bu parametreyi her zaman olarak falseayarlamanız kesinlikle önerilir. olarak ayarlanırsa dontEscapefalse, oluşturucu tüm yüzde oluşumlarının (%) geçerli bir kaçış dizisinin ardından geldiğini denetleyerek ayrılmış karakterlerden kurtulur. Bir yüzdeyi izleyen karakter dizisi geçerli değilse, yüzde değeri %25ile değiştirilir.

Bu oluşturucu, öğesinin erişilebilir bir kaynağa başvurduğundan Uri emin değildir.

Arayanlara Notlar

Güvenlik endişeleri nedeniyle, uygulamanız güvenilmeyen kaynaklardan URI dizeleri ve dontEscape olarak ayarlanmış olan bu oluşturucuyu trueçağırmamalıdır. Alternatif olarak, bu oluşturucuyu çağırmadan önce yöntemini çağırarak IsWellFormedOriginalString() bir URI dizesinin geçerliliğini denetleyebilirsiniz.

Şunlara uygulanır