Uri Oluşturucular

Kaynak:

Uri.cs

Kaynak:

Uri.cs

Kaynak:

Uri.cs

public:
 Uri(System::String ^ uriString);

public Uri (string uriString);

new Uri : string -> Uri

Public Sub New (uriString As String)

Parametreler

Özel durumlar

Örnekler

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

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

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

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

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

Açıklamalar

Bu oluşturucu bir URI dizesinden bir Uri örnek oluşturur. URI'yi ayrıştırıp 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.

Bu oluşturucu, parametresinin string mutlak bir URI'ye başvurduğunu ve oluşturucuyu Uri olarak ayarlanmış Absoluteolarak çağırmaya UriKind eşdeğer olduğunu varsayar. string Oluşturucuya geçirilen parametre göreli bir URI ise, bu oluşturucu bir UriFormatExceptionoluşturur.

Kaynak:

Uri.cs

Kaynak:

Uri.cs

Kaynak:

Uri.cs

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}")]
protected Uri (System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext);

new Uri : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> Uri

[<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

Protected Sub New (serializationInfo As SerializationInfo, streamingContext As StreamingContext)

Parametreler

Öznitelikler

ObsoleteAttribute

Özel durumlar

Açıklamalar

Bu oluşturucu sınıfı için arabirimini Uri uygularISerializable.

Ayrıca bkz.

• XML ve SOAP Serileştirme

Kaynak:

Uri.cs

Kaynak:

Uri.cs

Kaynak:

Uri.cs

public:
 Uri(System::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("This constructor has been deprecated; the dontEscape parameter is always false. 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. http://go.microsoft.com/fwlink/?linkid=14202")]
public Uri (string uriString, bool dontEscape);

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")>]
new Uri : string * bool -> Uri

[<System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. 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. 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

Öznitelikler

ObsoleteAttribute

Özel durumlar

Örnekler

Aşağıdaki örnek, URI http://www.contoso.com/Hello%20World.htmiçin bir Uri örnek oluşturur. İçeren URI tamamen kaçış olduğundan ve kurallı biçimde olduğundan parametresi dontEscape olarak trueayarlanabilir.

Uri^ myUri = gcnew Uri(  "http://www.contoso.com/Hello%20World.htm",true );

Uri myUri = new Uri("http://www.contoso.com/Hello%20World.htm", true);

let myUri = Uri("http://www.contoso.com/Hello%20World.htm", true)

Dim myUri As New Uri("http://www.contoso.com/Hello%20World.htm", True)

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 URI'deki tüm ayrılmış karakterlerin kaçıldığından eminseniz olarak ayarlanmalıdır true . Değerin true tam olarak kaçılmayan bir URI için olarak ayarlanması beklenmeyen davranışa 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 ardından geçerli bir kaçış dizisi eklenip izlenmediğini denetleyerek ayrılmış karakterlerden kurtular. Bir yüzdeyi izleyen karakter dizisi geçerli değilse, yüzde %25 ile değiştirilir.

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

Kaynak:

Uri.cs

Kaynak:

Uri.cs

Kaynak:

Uri.cs

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

Kaynak:

Uri.cs

Kaynak:

Uri.cs

Kaynak:

Uri.cs

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

Özel durumlar

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 belirttiğiniz değer, içinde uriKinduriStringgeçirilen URI türüyle eşleşmelidir. Ancak belirtilirse RelativeOrAbsolute , URI dizesi göreli veya mutlak olabilir.

Kaynak:

Uri.cs

Kaynak:

Uri.cs

Kaynak:

Uri.cs

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

Özel durumlar

Örnekler

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

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

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 relativeUribirleştirerek baseUri bir Uri örnek oluşturur. Mutlak bir URI ise relativeUri (şema, ana bilgisayar adı ve isteğe bağlı olarak bir bağlantı noktası numarası içeren), Uri örnek yalnızca relativeUrikullanılarak oluşturulur.

göreli baseUri parçaları (gibi/api) varsa göreli parça, yapılandırılmış Uriiçinde korunacaksa göreli parça baseUri eğik çizgiyle (gibi/api/) sonlandırılmalıdır.

Buna ek olarak, eğik çizgi ile başlıyorsa relativeUri , baseUri

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

Kaynak:

Uri.cs

Kaynak:

Uri.cs

Kaynak:

Uri.cs

public:
 Uri(Uri ^ baseUri, Uri ^ relativeUri);

public Uri (Uri baseUri, Uri relativeUri);

new Uri : Uri * Uri -> Uri

Public Sub New (baseUri As Uri, relativeUri As Uri)

Parametreler

Özel durumlar

Örnekler

Bu örnek, absoluteUrimutlak Uri bir örneği ve gö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.
String^ addressString1 = "http://www.contoso.com/";
String^ addressString2 = "catalog/shownew.htm?date=today";
Uri^ absoluteUri = gcnew Uri(addressString1);

// Create a relative Uri from a string.  allowRelative = true to allow for 
// creating a relative Uri.
Uri^ relativeUri = gcnew Uri(addressString2);

// 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 = gcnew Uri( absoluteUri,relativeUri );
Console::WriteLine( combinedUri->AbsoluteUri );

// 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, mutlak Uri örneği olan öğesini göreli Uri bir örnekle baseUribirleştirerek yeni Uri bir örnek relativeUrioluşturur. Mutlak bir örnekse relativeUri (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.Uri

göreli baseUri parçaları (gibi/api) varsa göreli parça, yapılandırılmış Uriiçinde korunacaksa göreli parça baseUri eğik çizgiyle (gibi/api/) sonlandırılmalıdır.

Buna ek olarak, eğik çizgi ile başlıyorsa relativeUri , baseUri

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

Kaynak:

Uri.cs

Kaynak:

Uri.cs

Kaynak:

Uri.cs

public:
 Uri(Uri ^ baseUri, System::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.")]
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("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("This constructor has been deprecated; the dontEscape parameter is always false. 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. 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

Öznitelikler

ObsoleteAttribute

Özel durumlar

Örnekler

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

Uri^ baseUri = gcnew Uri( "http://www.contoso.com/" );
Uri^ myUri = gcnew Uri( baseUri,"Hello%20World.htm",false );

Uri baseUri = new Uri("http://www.contoso.com");
Uri myUri = new Uri(baseUri, "Hello%20World.htm",false);

let baseUri = Uri "http://www.contoso.com"
let myUri = Uri(baseUri, "Hello%20World.htm", false)

Dim baseUri As New Uri("http://www.contoso.com")
Dim myUri As New Uri(baseUri, "Hello%20World.htm", False)

Açıklamalar

Bu oluşturucu ve relativeUribirleştirerek baseUri bir Uri örnek oluşturur. geçirilen relativeUri URI mutlak bir URI ise (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 URI'deki tüm ayrılmış karakterlerin kaçıldığından eminseniz olarak ayarlanmalıdır true . Değerin true tam olarak kaçılmayan bir URI için olarak ayarlanması beklenmeyen davranışa 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 ardından geçerli bir kaçış dizisi eklenip izlenmediğini denetleyerek ayrılmış karakterlerden kurtular. Bir yüzdeyi izleyen karakter dizisi geçerli değilse, yüzde %25 ile değiştirilir.

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

Arayanlara Notlar

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