다음을 통해 공유


Cookie 생성자

정의

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

오버로드

Cookie()

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

Cookie(String, String)

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

Cookie(String, String, String)

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

Cookie(String, String, String, String)

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

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

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

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

설명

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

적용 대상

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

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

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

value
String

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

예외

name 매개 변수가 null.

-또는-

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

-또는-

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

-또는-

value 매개 변수가 null.

-또는-

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

설명

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

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

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

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

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

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

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

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(Cookie) 또는 Add(Uri, Cookie) 메서드를 사용하여 이 CookieCookieContainer 인스턴스에 추가하려고 하면 작업이 실패하고 예외가 throw됩니다.

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

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

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

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

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

value
String

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

path
String

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

___domain
String

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

예외

name 매개 변수가 null.

-또는-

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

-또는-

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

-또는-

value 매개 변수가 null.

-또는-

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

설명

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

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

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

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

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

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

추가 정보

적용 대상