Uri Oluşturucular
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Uri sınıfının yeni bir örneğini başlatır.
Aşırı Yüklemeler
Uri(String) |
Belirtilen URI ile sınıfının yeni bir örneğini Uri başlatır. |
Uri(SerializationInfo, StreamingContext) |
Geçersiz.
ve StreamingContext sınıflarının Uri belirtilen örneklerinden sınıfının yeni bir örneğini SerializationInfo başlatır. |
Uri(String, Boolean) |
Geçersiz.
Geçersiz.
Geçersiz.
Karakter kaçışının Uri açık denetimiyle belirtilen URI ile sınıfının yeni bir örneğini başlatır. |
Uri(String, UriCreationOptions) |
Belirtilen URI ve ek UriCreationOptionsile sınıfının yeni bir örneğini Uri 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 temel Uri örnekle göreli Uri örneğin Uri birleşimine göre sınıfının yeni bir örneğini başlatır. |
Uri(Uri, String, Boolean) |
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ın açık denetimine sahip. |
Uri(String)
- 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. 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]".
Özel durumlar
uriString
, null
değeridir.
Not: Windows Mağazası uygulamaları için .NET'te veya Taşınabilir Sınıf Kitaplığı'nda bunun yerine temel sınıf özel durumunu FormatExceptionyakalayın.
uriString
boş.
-veya-
içinde uriString
belirtilen şema doğru biçimlendirilmemiş. Bkz. CheckSchemeName(String).
-veya-
uriString
çok fazla eğik çizgi içeriyor.
-veya-
içinde uriString
belirtilen parola geçerli değil.
-veya-
içinde uriString
belirtilen ana bilgisayar adı geçerli değil.
-veya-
içinde uriString
belirtilen dosya adı geçerli değil.
-veya-
içinde uriString
belirtilen kullanıcı adı geçerli değil.
-veya-
içinde uriString
belirtilen konak veya yetkili adı ters eğik çizgilerle sonlandırılamaz.
-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.
-veya-
içinde uriString
belirtilen düzenin uzunluğu 1023 karakteri aşıyor.
-veya-
içinde uriString
geçersiz bir karakter dizisi var.
-veya-
içinde uriString
belirtilen MS-DOS yolu c:\\ ile başlamalıdır.
Ö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.
Şunlara uygulanır
Uri(SerializationInfo, StreamingContext)
- 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 StreamingContext sınıflarının Uri belirtilen örneklerinden sınıfının yeni bir örneğini SerializationInfo başlatır.
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
- serializationInfo
- SerializationInfo
Yeni Uri örneği seri hale getirmek için gereken bilgileri içeren sınıfın bir örneğiSerializationInfo.
- streamingContext
- StreamingContext
Yeni Uri örnekle ilişkilendirilmiş serileştirilmiş akışın kaynağını içeren sınıfının bir örneğiStreamingContext.
- Ö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 geçerli değil.
-veya-
URI'de belirtilen ana bilgisayar adı geçerli değil.
-veya-
URI'de belirtilen dosya adı geçerli değil.
-veya-
URI'de belirtilen kullanıcı adı geçerli değil.
-veya-
URI'de belirtilen konak veya yetkili adı ters eğik çizgilerle sonlandırılamaz.
-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.
-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şlamalıdır.
Açıklamalar
Bu oluşturucu sınıfı için arabirimini Uri uygularISerializable.
Ayrıca bkz.
Şunlara uygulanır
Uri(String, Boolean)
- Kaynak:
- Uri.cs
- Kaynak:
- Uri.cs
- Kaynak:
- Uri.cs
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
This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(string) instead.
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çışı açık denetimiyle.
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
- 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
değeridir.
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 uriString
belirtilen parola geçerli değil.
-veya-
içinde uriString
belirtilen ana bilgisayar adı geçerli değil.
-veya-
içinde uriString
belirtilen dosya adı geçerli değil.
-veya-
içinde uriString
belirtilen kullanıcı adı geçerli değil.
-veya-
içinde uriString
belirtilen ana bilgisayar veya yetkili adı ters eğik çizgilerle sonlandırılamaz.
-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.
-veya-
içinde uriString
belirtilen düzenin uzunluğu 1023 karakteri aşıyor.
-veya-
içinde uriString
geçersiz bir karakter dizisi var.
-veya-
içinde uriString
belirtilen MS-DOS yolu c:\\ ile başlamalıdır.
Örnekler
Aşağıdaki örnek, URI http://www.contoso.com/Hello%20World.htm
için bir Uri örnek oluşturur. İçeren URI tamamen kaçış olduğundan ve kurallı biçimde olduğundan parametresi dontEscape
olarak true
ayarlanabilir.
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 false
ayarlamanız kesinlikle önerilir.
olarak ayarlanırsa dontEscape
false
, 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.
Şunlara uygulanır
Uri(String, UriCreationOptions)
- Kaynak:
- Uri.cs
- Kaynak:
- Uri.cs
- Kaynak:
- Uri.cs
Belirtilen URI ve ek UriCreationOptionsile sınıfının yeni bir örneğini Uri 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
- 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
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. 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]".
- uriKind
- UriKind
URI dizesinin göreli bir URI mi, mutlak URI mi yoksa belirsiz mi olduğunu belirtir.
Özel durumlar
uriKind
geçersizdir.
uriString
, null
değeridir.
Not: Windows Mağazası uygulamaları için .NET'te veya Taşınabilir Sınıf Kitaplığı'nda bunun yerine temel sınıf özel durumunu FormatExceptionyakalayı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 şema doğru biçimlendirilmemiş. Bkz. CheckSchemeName(String).
-veya-
uriString
çok fazla eğik çizgi içeriyor.
-veya-
içinde uriString
belirtilen parola geçerli değil.
-veya-
içinde uriString
belirtilen ana bilgisayar adı geçerli değil.
-veya-
içinde uriString
belirtilen dosya adı geçerli değil.
-veya-
içinde uriString
belirtilen kullanıcı adı geçerli değil.
-veya-
içinde uriString
belirtilen ana bilgisayar veya yetkili adı ters eğik çizgilerle sonlandırılamaz.
-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.
-veya-
içinde uriString
belirtilen düzenin uzunluğu 1023 karakteri aşıyor.
-veya-
içinde uriString
geçersiz bir karakter dizisi var.
-veya-
içinde uriString
belirtilen MS-DOS yolu c:\\ ile başlamalıdır.
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 uriKind
uriString
geçirilen URI türüyle eşleşmelidir. Ancak belirtilirse RelativeOrAbsolute , URI dizesi göreli veya mutlak olabilir.
Şunlara uygulanır
Uri(Uri, String)
- 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
değeridir.
baseUri
mutlak Uri bir örnek değildir.
Not: Windows Mağazası uygulamaları için .NET'te veya Taşınabilir Sınıf Kitaplığı'nda bunun yerine temel sınıf özel durumunu FormatExceptionyakalayın.
ve birleştirilerek baseUri
relativeUri
oluşturulan URI boştur veya yalnızca boşluklar içerir.
-veya-
URI'de belirtilen şema birleştirilerek baseUri
oluşturulmuştur 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 baseUri
oluşturulan URI'de belirtilen parola geçerli relativeUri
değil.
-veya-
Birleştirilerek baseUri
oluşturulan URI'de belirtilen ana bilgisayar adı ve relativeUri
geçerli değil.
-veya-
Birleştirilerek baseUri
oluşturulan URI'de belirtilen dosya adı ve relativeUri
geçerli değil.
-veya-
Birleştirilerek baseUri
oluşturulan URI'de belirtilen kullanıcı adı ve relativeUri
geçerli değil.
-veya-
Birleştirilerek baseUri
oluşturulan URI'de belirtilen ana bilgisayar veya yetkili adı ve relativeUri
ters eğik çizgilerle sonlandırılamaz.
-veya-
Birleştirilerek baseUri
relativeUri
oluşturulan URI'de belirtilen bağlantı noktası numarası geçerli değil veya ayrıştırılamıyor.
-veya-
Birleştirilerek baseUri
oluşturulan ve relativeUri
65519 karakteri aşan URI'nin uzunluğu.
-veya-
Birleştirilerek baseUri
oluşturulan ve relativeUri
1023 karakteri aşan URI'de belirtilen düzenin uzunluğu.
-veya-
ve relativeUri
birleştirilerek baseUri
oluşturulan URI'de geçersiz bir karakter dizisi var.
-veya-
içinde uriString
belirtilen MS-DOS yolu c:\\ ile başlamalıdır.
Ö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.htm
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, "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 relativeUri
öğesini birleştirerek baseUri
bir Uri örnek oluşturur.
relativeUri
Mutlak bir URI ise (düzen, ana bilgisayar adı ve isteğe bağlı olarak bağlantı noktası numarası içeren), Uri örnek yalnızca relativeUri
kullanılarak oluşturulur.
baseUri
göreli bölümleri (gibi/api
) varsa göreli bölümü, yapılandırılmış Uriiçinde korunacaksa, göreli bölümü baseUri
eğik çizgiyle (gibi/api/
) sonlandırılmalıdır.
Ayrıca eğik çizgiyle 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
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
baseUri
mutlak Uri bir örnek değildir.
baseUri
, null
değeridir.
baseUri
mutlak Uri bir örnek değildir.
Not: Windows Mağazası uygulamaları için .NET'te veya Taşınabilir Sınıf Kitaplığı'nda bunun yerine temel sınıf özel durumunu FormatExceptionyakalayın.
birleştirilerek baseUri
relativeUri
oluşturulan URI boş veya yalnızca boşluk içeriyor.
-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 baseUri
oluşturulan URI'de belirtilen parola ve relativeUri
geçerli değil.
-veya-
Birleştirilerek baseUri
oluşturulan URI'de belirtilen ana bilgisayar adı ve relativeUri
geçerli değil.
-veya-
Birleştirilerek baseUri
oluşturulan URI'de belirtilen dosya adı ve relativeUri
geçerli değil.
-veya-
Birleştirilerek baseUri
oluşturulan URI'de belirtilen kullanıcı adı ve relativeUri
geçerli değil.
-veya-
URI'de belirtilen konak veya yetkili adı birleştirilerek baseUri
oluşturulur ve relativeUri
ters eğik çizgilerle sonlandırılamaz.
-veya-
Birleştirilerek baseUri
relativeUri
oluşturulan URI'de belirtilen bağlantı noktası numarası geçerli değil veya ayrıştırılamıyor.
-veya-
Birleştirilerek baseUri
oluşturulan ve relativeUri
65519 karakteri aşan URI'nin uzunluğu.
-veya-
Birleştirilerek baseUri
oluşturulan ve relativeUri
1023 karakteri aşan URI'de belirtilen düzenin uzunluğu.
-veya-
ve relativeUri
birleştirilerek baseUri
oluşturulan URI'de geçersiz bir karakter dizisi var.
-veya-
içinde uriString
belirtilen MS-DOS yolu c:\\ ile başlamalıdır.
Örnekler
Bu örnek, absoluteUri
mutlak Uri bir örneği ve göreli Uri örneği relativeUri
oluşturur. Ardından bu iki örnekten yeni Uri bir örneği combinedUri
oluş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, baseUri
mutlak Uri örneğini göreli Uri bir örnekle birleştirerek yeni Uri bir örnek relativeUri
oluşturur. Mutlak bir örnekse relativeUri
(düzen, ana bilgisayar adı ve isteğe bağlı olarak bağlantı noktası numarası içeren), Uri örnek yalnızca relativeUri
kullanılarak oluşturulur.Uri
baseUri
göreli bölümleri (gibi/api
) varsa göreli bölümü, yapılandırılmış Uriiçinde korunacaksa, göreli bölümü baseUri
eğik çizgiyle (gibi/api/
) sonlandırılmalıdır.
Ayrıca eğik çizgiyle 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, String, Boolean)
- Kaynak:
- Uri.cs
- Kaynak:
- Uri.cs
- Kaynak:
- Uri.cs
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
This constructor has been deprecated; the dontEscape parameter is always false. 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. 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ın açık denetimine sahip.
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
- baseUri
- Uri
Temel URI.
- relativeUri
- String
Temel URI'ye eklenecek göreli URI.
- dontEscape
- Boolean
true
tamamen kaçılırsa uriString
; değilse, false
.
- Öznitelikler
Özel durumlar
baseUri
, null
değeridir.
baseUri
mutlak Uri bir örnek değildir.
birleştirilerek baseUri
relativeUri
oluşturulan URI boş veya yalnızca boşluk içeriyor.
-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 baseUri
oluşturulan URI'de belirtilen parola ve relativeUri
geçerli değil.
-veya-
Birleştirilerek baseUri
oluşturulan URI'de belirtilen ana bilgisayar adı ve relativeUri
geçerli değil.
-veya-
Birleştirilerek baseUri
oluşturulan URI'de belirtilen dosya adı ve relativeUri
geçerli değil.
-veya-
Birleştirilerek baseUri
oluşturulan URI'de belirtilen kullanıcı adı ve relativeUri
geçerli değil.
-veya-
URI'de belirtilen konak veya yetkili adı birleştirilerek baseUri
oluşturulur ve relativeUri
ters eğik çizgilerle sonlandırılamaz.
-veya-
Birleştirilerek baseUri
relativeUri
oluşturulan URI'de belirtilen bağlantı noktası numarası geçerli değil veya ayrıştırılamıyor.
-veya-
Birleştirilerek baseUri
oluşturulan ve relativeUri
65519 karakteri aşan URI'nin uzunluğu.
-veya-
Birleştirilerek baseUri
oluşturulan ve relativeUri
1023 karakteri aşan URI'de belirtilen düzenin uzunluğu.
-veya-
ve relativeUri
birleştirilerek baseUri
oluşturulan URI'de geçersiz bir karakter dizisi var.
-veya-
içinde uriString
belirtilen MS-DOS yolu c:\\ ile başlamalıdır.
Ö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 relativeUri
birleş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çeren), Uri örnek yalnızca relativeUri
kullanı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çılmış olduğundan eminseniz olarak ayarlanmalıdır true
. Değerin true
tam olarak kaçılmayan bir URI için olarak ayarlanması beklenmeyen davranışlara neden olabilir. Bu parametreyi her zaman olarak false
ayarlamanız kesinlikle önerilir. olarak ayarlanırsa dontEscape
false
, oluşturucu tüm yüzde (%) oluşumlarının ardından geçerli bir kaçış dizisi eklenip izlenmediğini denetleyerek tüm ayrılmış karakterlerden kaçar. 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 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() geçerlilik için bir URI dizesini denetleyebilirsiniz.
Şunlara uygulanır
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin