Aracılığıyla paylaş

Cookie Oluşturucular

  • Başvuru

Tanım

Ad Alanı:
System.Net
Bütünleştirilmiş Kod:
System.Net.Primitives.dll
Bütünleştirilmiş Kod:
System.dll
Bütünleştirilmiş Kod:
netstandard.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

Cookie()

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

Belirtilen Name ve Valueile Cookie sınıfının yeni bir örneğini başlatır.
Cookie(String, String, String)

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

belirtilen Name, Value, Pathve Domainile Cookie sınıfının yeni bir örneğini başlatır.
Kaynak:
Cookie.cs
Kaynak:
Cookie.cs
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. Cookie sınıfının bir örneği kullanmadan önce en azından Name özelliğinin başlatılması gerektiğini unutmayın.

Şunlara uygulanır

Kaynak:
Cookie.cs
Kaynak:
Cookie.cs
Kaynak:
Cookie.cs

Belirtilen Name ve Valueile Cookie 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);
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.

Cookie için value 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 CookieAdd(Cookie) veya Add(Uri, Cookie) yöntemleriyle bir CookieContainer ö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, CookieContainer örneğine eklenebilen bir Cookie 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.

Şunlara uygulanır

Kaynak:
Cookie.cs
Kaynak:
Cookie.cs
Kaynak:
Cookie.cs

belirtilen Name, Valueve Pathile Cookie 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);
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.

Cookie için value 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 CookieAdd(Cookie) veya Add(Uri, Cookie) yöntemleriyle bir CookieContainer ö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, CookieContainer örneğine eklenebilen bir Cookie 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.

Şunlara uygulanır

Kaynak:
Cookie.cs
Kaynak:
Cookie.cs
Kaynak:
Cookie.cs

belirtilen Name, Value, Pathve Domainile Cookie 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);
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.

Cookie için value 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 CookieAdd(Cookie) veya Add(Uri, Cookie) yöntemleriyle bir CookieContainer ö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, CookieContainer örneğine eklenebilen bir Cookie 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.

Şunlara uygulanır