HttpListenerResponse.AddHeader(String, String) 메서드

정의

지정된 헤더 및 값을 이 응답에 대한 HTTP 헤더에 추가합니다.Adds the specified header and value to the HTTP headers for this response.

public:
 void AddHeader(System::String ^ name, System::String ^ value);
public void AddHeader (string name, string value);
member this.AddHeader : string * string -> unit
Public Sub AddHeader (name As String, value As String)

매개 변수

name
String

설정할 HTTP 헤더의 이름입니다.The name of the HTTP header to set.

value
String

name 헤더의 값입니다.The value for the name header.

예외

namenull 또는 빈 문자열("")인 경우name is null or an empty string ("").

지정된 헤더에 값을 지정할 수 없는 경우You are not allowed to specify a value for the specified header.

또는-or- name 또는 value에 잘못된 문자가 들어 있는 경우name or value contains invalid characters.

value의 길이가 65,535자를 넘는 경우The length of value is greater than 65,535 characters.

예제

다음 코드 예제에서는이 속성을 사용 하 여 헤더를 추가 하는 방법을 보여 줍니다.The following code example demonstrates adding a header using this property.

public static void SetExpirationDate(long seconds, HttpListenerResponse response)
{
    response.AddHeader("Expires", seconds.ToString());
}
Public Shared Sub SetExpirationDate(ByVal seconds As Long, ByVal response As HttpListenerResponse)
    response.AddHeader("Expires", seconds.ToString())
End Sub

설명

이 메서드를 호출 하는 것은 Headers 속성에서 반환 된 컬렉션에 대해 Set 메서드를 호출 하는 것과 같습니다.Calling this method is equivalent to calling the Set method on the collection returned by the Headers property.

name에 지정 된 헤더가 없으면이 메서드는 Headers 속성의 컬렉션에 새 헤더를 삽입 합니다.If the header specified in name does not exist, this method inserts a new header into the Headers property's collection. name 컬렉션에 있으면이 메서드는 기존 값을 value바꿉니다.If name is present in the collection, this method replaces the existing value with value. 기존 값을 바꾸지 않고 기존 헤더에 값을 추가 하려면 AppendHeader 메서드를 사용 합니다.To add a value to an existing header without replacing the existing value, use the AppendHeader method.

적용 대상

추가 정보