Cookie 생성자

정의

네임스페이스:

System.Net

어셈블리:

netstandard.dll, System.Net.Primitives.dll

Cookie 클래스의 새 인스턴스를 초기화합니다. 일반적으로 애플리케이션은 HTTP 응답과 함께 수신된 Set-Cookie 헤더에 따라 자동으로 생성되므로 Cookie 클래스를 생성할 필요가 없습니다.

오버로드

Name	Description
Cookie()	Cookie 클래스의 새 인스턴스를 초기화합니다.
Cookie(String, String)	지정된 CookieName사용하여 Value 클래스의 새 인스턴스를 초기화합니다.
Cookie(String, String, String)	지정된 Cookie, Name및 Value사용하여 Path 클래스의 새 인스턴스를 초기화합니다.
Cookie(String, String, String, String)	지정된 Cookie, Name, Value및 Path사용하여 Domain 클래스의 새 인스턴스를 초기화합니다.

Cookie()

Source:

Cookie.cs

Cookie 클래스의 새 인스턴스를 초기화합니다.

public:
 Cookie();

public Cookie();

Public Sub New ()

설명

매개 변수가 없는 생성자는 name, value, path및 domain빈 문자열("")을 사용하여 모든 필드를 기본값으로 초기화합니다. Name 클래스의 인스턴스를 사용하기 전에 적어도 Cookie 속성을 초기화해야 합니다.

Cookie(String, String)

Source:

Cookie.cs

지정된 CookieName사용하여 Value 클래스의 새 인스턴스를 초기화합니다.

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)

매개 변수

name

String

Cookie이름입니다. 등호, 세미콜론, 쉼표, 줄 바꿈(\n), return(\r), tab(\t) 및 공백 문자와 같은 문자는 name내에서 사용하면 안 됩니다. 달러 기호 문자("$")는 첫 번째 문자가 될 수 없습니다.

value

String

Cookie값입니다. 세미콜론, 쉼표와 같은 문자는 value내에서 사용하면 안 됩니다.

예외

CookieException

name 매개 변수가 null.

-또는-

name 매개 변수의 길이는 0입니다.

-또는-

name 매개 변수에 잘못된 문자가 포함되어 있습니다.

-또는-

value 매개 변수가 null.

-또는-

value 매개 변수에는 잘못된 문자가 포함된 따옴표로 묶지 않은 문자열이 포함되어 있습니다.

설명

value 매개 변수의 기본값은 빈 문자열("")을 사용합니다.

value Cookie 매개 변수는 null 참조가 아니어야 합니다(Visual Basic에서는 Nothing). 세미콜론(";") 및 쉼표(",") 문자는 예약되어 있으며 value 매개 변수에 전달된 문자열이 큰따옴표로 묶이지 않는 한 value 매개 변수에 전달할 수 없습니다. 따라서 다음 예제 생성자는 성공하지만 Cookie 또는 CookieContainer 메서드를 사용하여 이 Add(Cookie)Add(Uri, Cookie) 인스턴스에 추가하려고 하면 작업이 실패하고 예외가 throw됩니다.

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

그러나 이러한 특수 문자가 이스케이프된 다음 생성자는 Cookie 인스턴스에 추가할 수 있는 CookieContainer 만듭니다.

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

쉼표 문자는 같은 줄에 있는 별도의 쿠키 사이의 구분 기호로 사용됩니다.

추가 정보

• CookieCollection
• CookieContainer
• CookieException

Cookie(String, String, String)

Source:

Cookie.cs

지정된 Cookie, Name및 Value사용하여 Path 클래스의 새 인스턴스를 초기화합니다.

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)

매개 변수

name

String

Cookie이름입니다. 등호, 세미콜론, 쉼표, 줄 바꿈(\n), return(\r), tab(\t) 및 공백 문자와 같은 문자는 name내에서 사용하면 안 됩니다. 달러 기호 문자("$")는 첫 번째 문자가 될 수 없습니다.

value

String

Cookie값입니다. 세미콜론, 쉼표와 같은 문자는 value내에서 사용하면 안 됩니다.

path

String

이 Cookie 적용되는 원본 서버의 URI 하위 집합입니다. 기본값은 "/"입니다.

예외

CookieException

name 매개 변수가 null.

-또는-

name 매개 변수의 길이는 0입니다.

-또는-

name 매개 변수에 잘못된 문자가 포함되어 있습니다.

-또는-

value 매개 변수가 null.

-또는-

value 매개 변수에는 잘못된 문자가 포함된 따옴표로 묶지 않은 문자열이 포함되어 있습니다.

설명

path 매개 변수의 기본값은 빈 문자열("")을 사용합니다.

value Cookie 매개 변수는 null 참조가 아니어야 합니다(Visual Basic에서는 Nothing). 세미콜론(";") 및 쉼표(",") 문자는 예약되어 있으며 value 매개 변수에 전달된 문자열이 큰따옴표로 묶이지 않는 한 value 매개 변수에 전달할 수 없습니다. 따라서 다음 예제 생성자는 성공하지만 Cookie 또는 CookieContainer 메서드를 사용하여 이 Add(Cookie)Add(Uri, Cookie) 인스턴스에 추가하려고 하면 작업이 실패하고 예외가 throw됩니다.

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

그러나 이러한 특수 문자가 이스케이프된 다음 생성자는 Cookie 인스턴스에 추가할 수 있는 CookieContainer 만듭니다.

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

쉼표 문자는 같은 줄에 있는 별도의 쿠키 사이의 구분 기호로 사용됩니다.

추가 정보

• CookieCollection
• CookieContainer
• CookieException

Cookie(String, String, String, String)

Source:

Cookie.cs

지정된 Cookie, Name, Value및 Path사용하여 Domain 클래스의 새 인스턴스를 초기화합니다.

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)

매개 변수

name

String

Cookie이름입니다. 등호, 세미콜론, 쉼표, 줄 바꿈(\n), return(\r), tab(\t) 및 공백 문자와 같은 문자는 name내에서 사용하면 안 됩니다. 달러 기호 문자("$")는 첫 번째 문자가 될 수 없습니다.

value

String

Cookie 개체의 값입니다. 세미콜론, 쉼표와 같은 문자는 value내에서 사용하면 안 됩니다.

path

String

이 Cookie 적용되는 원본 서버의 URI 하위 집합입니다. 기본값은 "/"입니다.

domain

String

이 Cookie 유효한 선택적 인터넷 도메인입니다. 기본값은 이 Cookie 받은 호스트입니다.

예외

CookieException

name 매개 변수가 null.

-또는-

name 매개 변수의 길이는 0입니다.

-또는-

name 매개 변수에 잘못된 문자가 포함되어 있습니다.

-또는-

value 매개 변수가 null.

-또는-

value 매개 변수에는 잘못된 문자가 포함된 따옴표로 묶지 않은 문자열이 포함되어 있습니다.

설명

domain 및 path 매개 변수의 기본값은 빈 문자열("")을 사용합니다.

value Cookie 매개 변수는 null 참조가 아니어야 합니다(Visual Basic에서는 Nothing). 세미콜론(";") 및 쉼표(",") 문자는 예약되어 있으며 value 매개 변수에 전달된 문자열이 큰따옴표로 묶이지 않는 한 value 매개 변수에 전달할 수 없습니다. 따라서 다음 예제 생성자는 성공하지만 Cookie 또는 CookieContainer 메서드를 사용하여 이 Add(Cookie)Add(Uri, Cookie) 인스턴스에 추가하려고 하면 작업이 실패하고 예외가 throw됩니다.

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

그러나 이러한 특수 문자가 이스케이프된 다음 생성자는 Cookie 인스턴스에 추가할 수 있는 CookieContainer 만듭니다.

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

쉼표 문자는 같은 줄에 있는 별도의 쿠키 사이의 구분 기호로 사용됩니다.

추가 정보

• CookieCollection
• CookieContainer
• CookieException