Cookie Oluşturucular

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.Primitives.dll

Cookie sınıfının yeni bir örneğini başlatır. Genel olarak, http yanıtıyla alınan Set-Cookie üst bilgisine göre otomatik olarak oluşturulduğundan bir uygulamanın Cookie sınıfı oluşturması gerekmez.

Aşırı Yüklemeler

Name	Description
Cookie()	Cookie sınıfının yeni bir örneğini başlatır.
Cookie(String, String)	Belirtilen Cookie ve Nameile Value sınıfının yeni bir örneğini başlatır.
Cookie(String, String, String)	belirtilen Cookie, Nameve Valueile Path sınıfının yeni bir örneğini başlatır.
Cookie(String, String, String, String)	belirtilen Cookie, Name, Valueve Pathile Domain sınıfının yeni bir örneğini başlatır.

Cookie()

Kaynak:

Cookie.cs

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

public:
 Cookie();

public Cookie();

Public Sub New ()

Açıklamalar

Parametresiz oluşturucu, name, value, pathve domainiçin boş dizeler ("") kullanarak tüm alanları varsayılan değerlerine başlatır. Name sınıfının bir örneği kullanmadan önce en azından Cookie özelliğinin başlatılması gerektiğini unutmayın.

Cookie(String, String)

Kaynak:

Cookie.cs

Belirtilen Cookie ve Nameile Value sınıfının yeni bir örneğini başlatır.

public:
 Cookie(System::String ^ name, System::String ^ value);

public Cookie(string name, string? value);

new System.Net.Cookie : string * string -> System.Net.Cookie

Public Sub New (name As String, value As String)

Parametreler

name

String

Cookieadı. Aşağıdaki karakterler nameiçinde kullanılmamalıdır: eşittir işareti, noktalı virgül, virgül, yeni satır (\n), return (\r), sekme (\t) ve boşluk karakteri. Dolar işareti karakteri ("$") ilk karakter olamaz.

value

String

Cookiedeğeri. Aşağıdaki karakterler valueiçinde kullanılmamalıdır: noktalı virgül, virgül.

Özel durumlar

CookieException

name parametresi null.

-veya-

name parametresi sıfır uzunluktadır.

-veya-

name parametresi geçersiz bir karakter içeriyor.

-veya-

value parametresi null.

-veya-

value parametresi, geçersiz karakter içeren tırnak içine alınmamış bir dize içeriyor.

Açıklamalar

value parametresi için varsayılan değer boş dizeyi ("") kullanır.

value için Cookie parametresi null başvurusu olmamalıdır (Visual Basic'te hiçbir şey). Noktalı virgül (";") ve virgül (",") karakterleri ayrılır ve value parametresinde geçirilen dize çift tırnak içine alınmadığı sürece value parametresinde geçirilemez. Bu nedenle aşağıdaki örnek oluşturucu başarılı olabilir, ancak bu CookieCookieContainer veya Add(Cookie) yöntemleriyle bir Add(Uri, Cookie) örneğine eklemeye çalıştığınızda işlem başarısız olur ve bir özel durum oluşturur:

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "123,456");
cookie.Domain = "contoso.com";
new CookieContainer().Add(cookie);

Ancak, bu özel karakterlerin kaçtığı aşağıdaki oluşturucu, Cookie örneğine eklenebilen bir CookieContainer oluşturur:

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "\"123,456\"");
cookie.Domain = "contoso.com";
new CookieContainer().Add(cookie);

Virgül karakteri, aynı satırdaki ayrı tanımlama bilgileri arasında sınırlayıcı olarak kullanılır.

Ayrıca bkz.

• CookieCollection
• CookieContainer
• CookieException

Cookie(String, String, String)

Kaynak:

Cookie.cs

belirtilen Cookie, Nameve Valueile Path sınıfının yeni bir örneğini başlatır.

public:
 Cookie(System::String ^ name, System::String ^ value, System::String ^ path);

public Cookie(string name, string? value, string? path);

new System.Net.Cookie : string * string * string -> System.Net.Cookie

Public Sub New (name As String, value As String, path As String)

Parametreler

name

String

Cookieadı. Aşağıdaki karakterler nameiçinde kullanılmamalıdır: eşittir işareti, noktalı virgül, virgül, yeni satır (\n), return (\r), sekme (\t) ve boşluk karakteri. Dolar işareti karakteri ("$") ilk karakter olamaz.

value

String

Cookiedeğeri. Aşağıdaki karakterler valueiçinde kullanılmamalıdır: noktalı virgül, virgül.

path

String

Bu Cookie uygulandığı kaynak sunucudaki URI'lerin alt kümesi. Varsayılan değer "/" değeridir.

Özel durumlar

CookieException

name parametresi null.

-veya-

name parametresi sıfır uzunluktadır.

-veya-

name parametresi geçersiz bir karakter içeriyor.

-veya-

value parametresi null.

-veya-

value parametresi, geçersiz karakter içeren tırnak içine alınmamış bir dize içeriyor.

Açıklamalar

path parametresi için varsayılan değer boş dizeyi ("") kullanır.

value için Cookie parametresi null başvurusu olmamalıdır (Visual Basic'te hiçbir şey). Noktalı virgül (";") ve virgül (",") karakterleri ayrılır ve value parametresinde geçirilen dize çift tırnak içine alınmadığı sürece value parametresinde geçirilemez. Bu nedenle aşağıdaki örnek oluşturucu başarılı olabilir, ancak bu CookieCookieContainer veya Add(Cookie) yöntemleriyle bir Add(Uri, Cookie) örneğine eklemeye çalıştığınızda işlem başarısız olur ve bir özel durum oluşturur:

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "123,456", "");
cookie.Domain = "contoso.com";
new CookieContainer().Add(cookie);

Ancak, bu özel karakterlerin kaçtığı aşağıdaki oluşturucu, Cookie örneğine eklenebilen bir CookieContainer oluşturur:

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "\"123,456\"", "");
cookie.Domain = "contoso.com";
new CookieContainer().Add(cookie);

Virgül karakteri, aynı satırdaki ayrı tanımlama bilgileri arasında sınırlayıcı olarak kullanılır.

Ayrıca bkz.

• CookieCollection
• CookieContainer
• CookieException

Cookie(String, String, String, String)

Kaynak:

Cookie.cs

belirtilen Cookie, Name, Valueve Pathile Domain sınıfının yeni bir örneğini başlatır.

public:
 Cookie(System::String ^ name, System::String ^ value, System::String ^ path, System::String ^ domain);

public Cookie(string name, string? value, string? path, string? domain);

new System.Net.Cookie : string * string * string * string -> System.Net.Cookie

Public Sub New (name As String, value As String, path As String, domain As String)

Parametreler

name

String

Cookieadı. Aşağıdaki karakterler nameiçinde kullanılmamalıdır: eşittir işareti, noktalı virgül, virgül, yeni satır (\n), return (\r), sekme (\t) ve boşluk karakteri. Dolar işareti karakteri ("$") ilk karakter olamaz.

value

String

Cookie nesnesinin değeri. Aşağıdaki karakterler valueiçinde kullanılmamalıdır: noktalı virgül, virgül.

path

String

Bu Cookie uygulandığı kaynak sunucudaki URI'lerin alt kümesi. Varsayılan değer "/" değeridir.

domain

String

Bu Cookie geçerli olduğu isteğe bağlı internet etki alanı. Varsayılan değer, bu Cookie alındığı konaktır.

Özel durumlar

CookieException

name parametresi null.

-veya-

name parametresi sıfır uzunluktadır.

-veya-

name parametresi geçersiz bir karakter içeriyor.

-veya-

value parametresi null.

-veya-

value parametresi, geçersiz karakter içeren tırnak içine alınmamış bir dize içeriyor.

Açıklamalar

domain ve path parametreleri için varsayılan değer boş dizeyi ("") kullanır.

value için Cookie parametresi null başvurusu olmamalıdır (Visual Basic'te hiçbir şey). Noktalı virgül (";") ve virgül (",") karakterleri ayrılır ve value parametresinde geçirilen dize çift tırnak içine alınmadığı sürece value parametresinde geçirilemez. Bu nedenle aşağıdaki örnek oluşturucu başarılı olabilir, ancak bu CookieCookieContainer veya Add(Cookie) yöntemleriyle bir Add(Uri, Cookie) örneğine eklemeye çalıştığınızda işlem başarısız olur ve bir özel durum oluşturur:

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "123,456", "", "contoso.com");
new CookieContainer().Add(cookie);

Ancak, bu özel karakterlerin kaçtığı aşağıdaki oluşturucu, Cookie örneğine eklenebilen bir CookieContainer oluşturur:

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "\"123,456\"", "", "contoso.com");
new CookieContainer().Add(cookie);

Virgül karakteri, aynı satırdaki ayrı tanımlama bilgileri arasında sınırlayıcı olarak kullanılır.

Ayrıca bkz.

• CookieCollection
• CookieContainer
• CookieException