다음을 통해 공유


Cookie 생성자

정의

Cookie 클래스의 새 인스턴스를 초기화합니다. 일반적으로 Cookie 클래스는 HTTP 응답과 함께 받은 Set-Cookie 헤더를 기준으로 자동으로 만들어지므로 애플리케이션에서 이 클래스를 생성할 필요는 없습니다.

오버로드

Cookie()

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

Cookie(String, String)

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

Cookie(String, String, String)

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

Cookie(String, String, String, String)

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

Source:
Cookie.cs
Source:
Cookie.cs
Source:
Cookie.cs

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

public:
 Cookie();
public Cookie ();
Public Sub New ()

설명

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

적용 대상

Source:
Cookie.cs
Source:
Cookie.cs
Source:
Cookie.cs

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

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)

매개 변수

name
String

Cookie 이름입니다. name에는 등호, 세미콜론, 쉼표, 줄 바꿈(\n), 리턴(\r), 탭(\t) 및 공백 문자와 같은 문자를 사용할 수 없습니다. 달러 기호("$")는 첫 문자로 사용할 수 없습니다.

value
String

Cookie의 값입니다. value에는 세미콜론, 쉼표 같은 문자를 사용할 수 없습니다.

예외

name 매개 변수가 null인 경우

또는

name 매개 변수의 길이가 0인 경우

또는

name 매개 변수에 잘못된 문자가 포함된 경우

또는

value 매개 변수가 null인 경우

또는

value 매개 변수에 잘못된 문자를 포함하며 따옴표로 묶이지 않은 문자열이 있는 경우

설명

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

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

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

추가 정보

적용 대상

Source:
Cookie.cs
Source:
Cookie.cs
Source:
Cookie.cs

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

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)

매개 변수

name
String

Cookie 이름입니다. name에는 등호, 세미콜론, 쉼표, 줄 바꿈(\n), 리턴(\r), 탭(\t) 및 공백 문자와 같은 문자를 사용할 수 없습니다. 달러 기호("$")는 첫 문자로 사용할 수 없습니다.

value
String

Cookie의 값입니다. value에는 세미콜론, 쉼표 같은 문자를 사용할 수 없습니다.

path
String

Cookie를 적용할 원본 서버에 있는 URI의 하위 집합입니다. 기본값은 "/"입니다.

예외

name 매개 변수가 null인 경우

또는

name 매개 변수의 길이가 0인 경우

또는

name 매개 변수에 잘못된 문자가 포함된 경우

또는

value 매개 변수가 null인 경우

또는

value 매개 변수에 잘못된 문자를 포함하며 따옴표로 묶이지 않은 문자열이 있는 경우

설명

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

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

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

추가 정보

적용 대상

Source:
Cookie.cs
Source:
Cookie.cs
Source:
Cookie.cs

지정된 Cookie, Name, ValuePath을 사용하여 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);
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 이름입니다. name에는 등호, 세미콜론, 쉼표, 줄 바꿈(\n), 리턴(\r), 탭(\t) 및 공백 문자와 같은 문자를 사용할 수 없습니다. 달러 기호("$")는 첫 문자로 사용할 수 없습니다.

value
String

Cookie 개체의 값입니다. value에는 세미콜론, 쉼표 같은 문자를 사용할 수 없습니다.

path
String

Cookie를 적용할 원본 서버에 있는 URI의 하위 집합입니다. 기본값은 "/"입니다.

domain
String

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

예외

name 매개 변수가 null인 경우

또는

name 매개 변수의 길이가 0인 경우

또는

name 매개 변수에 잘못된 문자가 포함된 경우

또는

value 매개 변수가 null인 경우

또는

value 매개 변수에 잘못된 문자를 포함하며 따옴표로 묶이지 않은 문자열이 있는 경우

설명

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

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

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

추가 정보

적용 대상