HttpContentHeaderCollection.ContentDisposition 속성

정의

HTTP 콘텐츠의 HTTP Content-Disposition 헤더 값을 나타내는 HttpContentDispositionHeaderValue 개체를 가져오거나 설정합니다.

public:
 property HttpContentDispositionHeaderValue ^ ContentDisposition { HttpContentDispositionHeaderValue ^ get(); void set(HttpContentDispositionHeaderValue ^ value); };
HttpContentDispositionHeaderValue ContentDisposition();

void ContentDisposition(HttpContentDispositionHeaderValue value);
public HttpContentDispositionHeaderValue ContentDisposition { get; set; }
var httpContentDispositionHeaderValue = httpContentHeaderCollection.contentDisposition;
httpContentHeaderCollection.contentDisposition = httpContentDispositionHeaderValue;
Public Property ContentDisposition As HttpContentDispositionHeaderValue

속성 값

HTTP 콘텐츠의 HTTP Content-Disposition 헤더 값을 나타내는 개체입니다. null 값은 헤더가 없음을 의미합니다.

설명

다음 샘플 코드에서는 HttpContentHeaderCollection 개체의 ContentDisposition 속성을 사용하여 HTTP 콘텐츠에서 Content-Disposition 헤더 값을 얻거나 설정하는 방법을 보여 줍니다.

// Content-Disposition header
// HttpContentDispositionHeaderValue
void DemoContentDisposition(IHttpContent content) {
    var h = content.Headers;

    HttpContentDispositionHeaderValue value;
    bool ok = HttpContentDispositionHeaderValue.TryParse("attachment; filename=\"myfile.txt\"; myparam=myvalue", out value);
    h.ContentDisposition = value;

    h.ContentDisposition = HttpContentDispositionHeaderValue.Parse("attachment; filename=\"myfile.txt\"; myparam=myvalue");
    var header = h.ContentDisposition;

    uiLog.Text += "\nCONTENT DISPOSITION HEADER\n";
    // Content-Disposition: attachment; filename="fname.ext"

    // ContentDisposition is a HttpContentDispositionHeaderValue and contains:
    // DispositionType, FileName, FileNameStar, Name: all strings
    // Size: nullable long
    // Parameters: IList<HttpNameValueHeaderValue> 
    var parameterString = "";
    foreach (var parameter in header.Parameters) {
        parameterString += string.Format("[{0}={1}] ", parameter.Name, parameter.Value);
    }
    if (parameterString == "") {
        parameterString = "(no parameters)";
    }

    uiLog.Text += string.Format("ContentDisposition: DispositionType: {0} FileName: {1} FileNameStar: {2} Name: {3} Parameters: {4} Size: {5} ToString: {6}\n\n", 
    header.DispositionType, header.FileName, header.FileNameStar, header.Name, parameterString, header.Size, header.ToString());
}

적용 대상

추가 정보