Cookie Oluşturucular

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

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 bilgisi temel alınarak otomatik olarak oluşturulduğundan bir uygulamanın sınıf oluşturması Cookie 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 sınıfının yeni bir örneğini Cookie başlatır.
Cookie(String, String, String)	Belirtilen Name, Valueve Pathile sınıfının yeni bir örneğini Cookie başlatır.
Cookie(String, String, String, String)	Belirtilen Name, , ValuePathve Domainile sınıfının yeni bir örneğini Cookie 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, , value, pathve domainiçin nameboş dizeler ("") kullanarak tüm alanları varsayılan değerlerine başlatır. Sınıfının bir örneği kullanmadan önce en azından Name özelliğin Cookie başlatılması gerektiğini unutmayın.

Cookie(String, String)

Kaynak:

Cookie.cs

belirtilen Name ve Valueile sınıfının yeni bir örneğini Cookie 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

Adı Cookie. Şu karakterler içinde namekullanılmamalıdır: eşittir işareti, noktalı virgül, virgül, yeni satır (\n), dönüş (\r), sekme (\t) ve boşluk karakteri. Dolar işareti karakteri ("$") ilk karakter olamaz.

value

String

değerinin Cookiedeğeri. Şu karakterler içinde valuekullanılmamalıdır: noktalı virgül, virgül.

Özel durumlar

CookieException

name parametresidirnull.

-veya-

name parametresi sıfır uzunluktadır.

-veya-

name parametresi geçersiz bir karakter içeriyor.

-veya-

value parametresidir null .

-Veya-

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

Açıklamalar

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

value parametresi Cookie bir başvuru olmamalıdır null (Visual Basic'te Hiçbir şey). Noktalı virgül (";") ve virgül (",") karakterleri ayrılır ve parametrede value geçirilen dize çift tırnak içine alınmadığı sürece parametrede value geçirilemez. Bu nedenle aşağıdaki örnek oluşturucu başarılı olur, ancak bunu Cookie veya Add(Uri, Cookie) yöntemleriyle Add(Cookie) bir CookieContainer örneğe 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çış karakterine sahip aşağıdaki oluşturucu, örneğe eklenebilen bir CookieContainer oluştururCookie:

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 Name, Valueve Pathile sınıfının yeni bir örneğini Cookie 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

Adı Cookie. Şu karakterler içinde namekullanılmamalıdır: eşittir işareti, noktalı virgül, virgül, yeni satır (\n), dönüş (\r), sekme (\t) ve boşluk karakteri. Dolar işareti karakteri ("$") ilk karakter olamaz.

value

String

değerinin Cookiedeğeri. Şu karakterler içinde valuekullanılmamalıdır: noktalı virgül, virgül.

path

String

Bunun geçerli olduğu Cookie kaynak sunucudaki URI'lerin alt kümesi. Varsayılan değer "/" değeridir.

Özel durumlar

CookieException

name parametresidirnull.

-veya-

name parametresi sıfır uzunluktadır.

-veya-

name parametresi geçersiz bir karakter içeriyor.

-veya-

value parametresidir null .

-Veya-

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

Açıklamalar

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

value parametresi Cookie bir başvuru olmamalıdır null (Visual Basic'te Hiçbir şey). Noktalı virgül (";") ve virgül (",") karakterleri ayrılır ve parametrede value geçirilen dize çift tırnak içine alınmadığı sürece parametrede value geçirilemez. Bu nedenle aşağıdaki örnek oluşturucu başarılı olur, ancak bunu Cookie veya Add(Uri, Cookie) yöntemleriyle Add(Cookie) bir CookieContainer örneğe 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çış karakterine sahip aşağıdaki oluşturucu, örneğe eklenebilen bir CookieContainer oluştururCookie:

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 Name, , ValuePathve Domainile sınıfının yeni bir örneğini Cookie 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

Adı Cookie. Şu karakterler içinde namekullanılmamalıdır: eşittir işareti, noktalı virgül, virgül, yeni satır (\n), dönüş (\r), sekme (\t) ve boşluk karakteri. Dolar işareti karakteri ("$") ilk karakter olamaz.

value

String

Nesnenin Cookie değeri. Şu karakterler içinde valuekullanılmamalıdır: noktalı virgül, virgül.

path

String

Bunun geçerli olduğu Cookie kaynak sunucudaki URI'lerin alt kümesi. Varsayılan değer "/" değeridir.

domain

String

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

Özel durumlar

CookieException

name parametresidirnull.

-veya-

name parametresi sıfır uzunluktadır.

-veya-

name parametresi geçersiz bir karakter içeriyor.

-veya-

value parametresidir null .

-Veya-

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

Açıklamalar

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

value parametresi Cookie bir başvuru olmamalıdır null (Visual Basic'te Hiçbir şey). Noktalı virgül (";") ve virgül (",") karakterleri ayrılır ve parametrede value geçirilen dize çift tırnak içine alınmadığı sürece parametrede value geçirilemez. Bu nedenle aşağıdaki örnek oluşturucu başarılı olur, ancak bunu Cookie veya Add(Uri, Cookie) yöntemleriyle Add(Cookie) bir CookieContainer örneğe 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çış karakterine sahip aşağıdaki oluşturucu, örneğe eklenebilen bir CookieContainer oluştururCookie:

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