문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

ASP.NET appSettings 요소

구성의 <appSettings> 요소에 웹 응용 프로그램을 사용자 지정하기 위한 설정이 포함되어 있습니다. <appSettings> 요소 내에서 응용 프로그램 설정을 키/값 쌍으로 add, removeclear할 수 있습니다.

<appSettings    <[add|clear|remove] key="configuration key value" value="value" /> </appSettings> 

aspnet:AllowAnonymousImpersonation

들어오는 요청이 인증되지 않은 경우 사용되는 가장 토큰 유형을 지정합니다.

Type:

Boolean

Default value:

false

Remarks:

appSettings 키는 특히 SharePoint와 관련이 있습니다. 응용 프로그램이 AppDomain 내에서 잠재적으로 신뢰할 수 없는 코드를 실행하는 경우 신뢰할 수 없는 코드가 실행 중인 ID에 주의해야 합니다. 이 키 값이 false[기본값]인 경우 특정 파이프라인 이벤트는 들어오는 요청이 인증되지 않으면 프로세스 ID의 가장 토큰을 사용합니다. 이 키 값이 true[기본값]인 경우 해당 파이프라인 이벤트는 들어오는 요청이 인증되지 않으면 익명 가장 토큰을 사용합니다.

Example:

    <appSettings>
      <add key="aspnet:AllowAnonymousImpersonation" value="false" />
    </appSettings>
중요 중요

고급 개발자만 이 설정을 수정해야 합니다.

aspnet:AllowAsyncDuringSyncStages

ASP.NET이 런타임 중 개발자가 비동기 코딩을 수행하는 동안 일반적으로 발생하는 실수를 잡아내기 위한 추가 확인을 수행할지 여부를 지정합니다.

Type:

Boolean

Default value:

false

Remarks:

이 키 값이 false[기본값]이고 UseTaskFriendlySynchronizationContext 키 값이 true인 경우 ASP.NET은 런타임 중 추가 검사를 수행합니다. 이러한 검사는 비동기 코딩에서 발생하는 일반적인 실수를 잡아냅니다. 그 외의 경우에는 검사가 수행되지 않습니다. 이 검사는 동기 페이지를 실행하는 동안 비동기 작업을 시작하려고 하거나 처리 중인 비동기 작업이 있는 경우 IHttpModule 또는 IHttpAsyncHandler를 실행하여 완료하려는 경우와 같은 실수를 검색합니다. 이러한 실수로 교착 상태가 발생하거나 ASP.NET 응용 프로그램의 성능이 제한될 수 있습니다.

Example:

    <appSettings>
      <add key="aspnet:AllowAsyncDuringSyncStages" value="false" />
    </appSettings>
aspnet:AllowRelaxedHttpUserName

ASP.NET이 웹 서버의 관리(ASP.NET) 레이어와 기본(IIS) 레이어 간의 클라이언트 사용자 이름을 동기화하는 방법을 지정합니다.

Type:

Boolean

Default value:

false

Remarks:

이 키 값이 false[기본값]인 경우 ASP.NET은 이 동기화 단계를 수행하기 전에 클라이언트의 사용자 이름을 확인합니다. 이 키 값이 true인 경우 ASP.NET은 검사를 수행하지 않습니다.

Example:

    <appSettings>
      <add key="aspnet:AllowRelaxedHttpUserName" value="false" />
    </appSettings>
주의 정보 주의

이 특성을 true로 설정하면 보안 위험이 발생할 수 있습니다.

aspnet:AllowRelaxedRelativeUrl

ASP.NET 로그인 페이지가 대상이 호스팅된 응용 프로그램 외부에 있는 URL을 반환하도록 리디렉션하는 방법을 지정합니다.

Type:

Boolean

Default value:

false

Remarks:

이 키 값이 false[기본값]인 경우 ASP.NET 로그인 페이지는 대상이 호스팅된 응용 프로그램 외부에 있는 URL을 반환하도록 리디렉션하지 않습니다. 이 키 값이 true인 경우 ASP.NET 로그인 페이지는 반환 URL에 대한 검사를 수행하지 않으며 이와 상관없이 반환 URL에 리디렉션합니다.

Example:

    <appSettings>
      <add key="aspnet:AllowRelaxedRelativeUrl" value="false" />
    </appSettings>
주의 정보 주의

이 특성을 true로 설정하면 보안 위험이 발생할 수 있습니다.

aspnet:AllowRelaxedUnicodeDecoding

ASP.NET이 들어오는 클라이언트 제공 데이터에 대한 추가 유니코드 유효성 검사를 수행할지 여부를 지정합니다.

Type:

Boolean

Default value:

false

Remarks:

이 값이 false[기본값]인 경우 ASP.NET은 들어오는 클라이언트 제공 데이터에 대한 추가 유니코드 유효성 검사를 수행합니다. 이 키 값이 true인 경우 ASP.NET은 추가 유효성 검사를 수행하지 않습니다.

Example:

    <appSettings>
      <add key="aspnet:AllowRelaxedUnicodeDecoding" value="false" />
    </appSettings>
aspnet:AllowUtf7RequestContentEncoding

클라이언트에서 Content-Encoding 헤더에 대한 인코딩을 지정할 수 있는지 여부를 지정합니다.

Type:

Boolean

Default value:

false

Remarks:

기본적으로 ASP.NET은 클라이언트가 들어오는 페이로드 데이터의 텍스트 인코딩을 지정하도록 허용합니다. 클라이언트는 Content-Encoding 헤더를 통해 이 정보를 보낼 수 있으며 ASP.NET은 ContentEncoding 속성을 통해 이 정보를 반영합니다. 키 값이 false[기본값]인 경우 클라이언트는 ASP.NET이 들어오는 페이로드를 UTF-7로 취급함을 요청하는 데 Content-Encoding 헤더를 사용할 수 없습니다. 키 값이 true인 경우 클라이언트는 Content-Encoding 헤더에 대한 모든 인코딩(UTF-7 포함)을 지정할 수 있으며 ASP.NET은 해당 인코딩을 사용하여 들어오는 페이로드를 해석하려고 합니다. UTF-7에 대한 자세한 내용은 UTF7Encoding 클래스를 참조하십시오.

Example:

    <appSettings>
      <add key="aspnet:AllowUtf7RequestContentEncoding" value="false" />
    </appSettings>
aspnet:DoNotDisposeSpecialHttpApplicationInstances

ASP.NET이 응용 프로그램 인스턴스화를 수행하는 데 사용되는 등록된 모든 IHttpModule 형식의 "특별" 인스턴스를 삭제하는지 여부를 지정합니다.

Type:

Boolean

Default value:

false

Remarks:

ASP.NET 응용 프로그램이 처음 시작할 때 등록된 모든 IHttpModule형식의 "특별" 인스턴스가 만들어집니다. 이러한 특별 인스턴스는 응용 프로그램 인스턴스화를 수행하는 데 사용됩니다. 이러한 특별 인스턴스는 요청을 서비스하는 데 실제로 사용되지 않습니다. 키 값이 false[기본값]인 경우 이러한 특별 인스턴스는 응용 프로그램이 종료될 때 삭제(IHttpModule에서 IDisposable 구현)됩니다. 이 키 값이 true인 경우 이러한 특별 인스턴스가 삭제되지 않습니다.

Example:

    <appSettings>
      <add key="aspnet:DoNotDisposeSpecialHttpApplicationInstances" value="false" />
    </appSettings>
aspnet:FormsAuthReturnUrlVar

폼 인증을 완료한 후 사용할 반환 URL을 지정합니다.

Type:

String

Default value:

[빈 문자열]

Remarks:

appSettings 키는 특히 SharePoint와 관련이 있습니다. 이 키 값이 설정된 경우 해당 값은 웹 응용 프로그램의 클라이언트가 인증을 완료(ASP.NET 멤버 자격을 통해 로그인)한 후 반환 URL로 사용됩니다. 이 값이 비어 있으면 인증 후 클라이언트는 인증 시 사용된 ReturnUrl 쿼리 문자열 매개 변수를 기반으로 리디렉션됩니다.

Example:

    <appSettings>
      <add key="aspnet:FormsAuthReturnUrlVar" value="" />
    </appSettings>
aspnet:JavaScriptDoNotEncodeAmpersand

기본 제공된 JavaScript 문자열 인코딩 루틴이 앰퍼샌드('&') 문자를 인코딩하는지에 대해 지정합니다.

Type:

Boolean

Default value:

false

Remarks:

이 키 값이 false[기본값]인 경우 기본 제공된 JavaScript 문자열 인코딩 루틴은 앰퍼샌드('&') 문자를 해당 문자의 JavaScript 이스케이프 형식인 "\u0026"으로 인코딩합니다. 키 값이 true인 경우 기본 제공된 JavaScript 문자열 인코딩 루틴은 앰퍼샌드 문자를 인코딩하지 않습니다.

Example:

    <appSettings>
      <add key="aspnet:JavaScriptDoNotEncodeAmpersand" value="false" />
    </appSettings>
주의 정보 주의

이 특성을 true로 설정하면 보안 위험이 발생할 수 있습니다.

aspnet:MaxConcurrentCompilations

웹 디렉터리의 종속되지 않은 병렬 컴파일을 제어합니다.

Type:

Int32

Default value:

1

Remarks:

이 키 값이 "0"인 경우 모든 서버 코어가 동시 컴파일에 사용됩니다. 키 값이 "1"[기본]인 경우 동시 컴파일이 비활성화됩니다. 키 값이 "2" 이상인 경우 동시 코어 컴파일이 이 값으로 명시적으로 설정되며 최대값으로 작동합니다.

사용 가능한 코어가 있는 사용자(공유되지 않은 호스팅)는 이 설정을 사용하여 시작 시간을 향상할 수 있습니다. 가능한 경우 이 응용 프로그램 설정을 서버의 코어 수로 설정합니다. 이 설정은 특히 현재 컴파일의 혜택을 얻기 위한 4.0 응용 프로그램을 위한 것이지만 4.0 응용 프로그램에서 컴파일 요소에 대한 4.5 지정 특성을 설정할 수 없습니다. 또한, 이 응용 프로그램 설정은 4.5를 실행 중인 호스트에 배포할 때 응용 프로그램을 특별히 취소할 수 있도록 합니다.

Example:

    <appSettings>
      <add key="aspnet:MaxConcurrentCompilations" value="1" />
    </appSettings>
aspnet:MaxHttpCollectionKeys

HttpRequest 개체의 클라이언트 제공 사전에 제공할 수 있는 최대 항목 수를 제한합니다.

Type:

Int32

Default value:

1000

Remarks:

클라이언트 제공 사전에는 HttpRequest.Files, HttpRequest.Form, HttpRequest.Cookies, HttpRequest.QueryString, HttpRequest.Headers, HttpRequest.ServerVariables가 포함됩니다.

Example:

    <appSettings>
      <add key="aspnet:MaxHttpCollectionKeys" value="1000" />
    </appSettings>
주의 정보 주의

이 특성을 너무 큰 숫자로 설정하면 보안 위험이 발생할 수 있습니다.

aspnet:MaxJsonDeserializerMembers

JavaScriptSerializer 형식으로 deserialize된 모든 사전에 제공할 수 있는 최대 항목 수 제한을 지정합니다.

Type:

Int32

Default value:

1000

Remarks:

Example:

    <appSettings>
      <add key="aspnet:MaxJsonDeserializerMembers" value="1000" />
    </appSettings>
주의 정보 주의

이 특성을 너무 큰 숫자로 설정하면 보안 위험이 발생할 수 있습니다.

aspnet:RestrictXmlControls

ASP.NET은 XSLT를 로드하는 방식을 지정합니다.

Type:

Boolean

Default value:

false

Remarks:

이 키 값이 false[기본값]인 경우 ASP.NET의 XML 컨트롤은 XSLT 작업에 XslTransform을 사용합니다. 이 키 값이 true[기본값]인 경우 ASP.NET의 XML 컨트롤은 XSLT 작업에 XslCompiledTransform을 사용합니다.

Example:

    <appSettings>
      <add key="aspnet:RestrictXmlControls" value="false" />
    </appSettings>
aspnet:ScriptResourceAllowNonJsFiles

Web Forms 페이지에 태그 <asp:ScriptReference Path="~/the-file.ext" />가 포함되어 있는 경우 ScriptResource.axd 처리기가 하드 드라이브에서 정적 파일을 사용할 수 있는지 여부를 지정합니다.

Type:

Boolean

Default value:

false

Remarks:

ScriptResource.axd 처리기는 하드 드라이브에서 임의의 정적 파일을 사용할 수 있습니다. value 특성이 false[기본값]인 경우 ScriptResource.axd는 파일에 .js 확장자가 없으면 파일에 대한 요청을 처리하지 않습니다. value 특성이 true인 경우 ScriptResource.axd는 모든 파일에 대한 요청을 처리합니다.

Example:

    <appSettings>
      <add key="aspnet:ScriptResourceAllowNonJsFiles" value="false" />
    </appSettings>
주의 정보 주의

이 특성을 true로 설정하면 보안 위험이 발생할 수 있습니다. 악의적인 클라이언트는 웹 사이트에서 중요한 파일을 읽을 수 있습니다.

aspnet:UpdatePanelMaxScriptLength

JavaScriptSerializer가 큰 JSON 페이로드를 클라이언트에 전송할 때 허용할 제한을 임시적으로 재정의하는 데 ScriptManager가 사용하는 JSON 페이로드 크기 제한 값을 제정합니다.

Type:

Int32

Default value:

0

Remarks:

JavaScriptSerializer 형식에는 생성하거나 사용할 수 있는 최대 JSON 페이로드 크기에 대한 제한이 있습니다. 이 제한의 기본값은 2MB이며 MaxJsonLength 속성을 통해 구성할 수 있습니다. ScriptManager 형식은 JavaScriptSerializer를 내부적으로 사용합니다. 이 키 값이 0보다 큰 값으로 설정된 경우 ScriptManager는 제공된 키 값을 JSON 페이로드 크기 제한으로 사용하여 큰 JSON 페이로드를 클라이언트에 전송할 때 JavaScriptSerializer에서 허용하는 제한을 임시로 재정의합니다. 이 스위치가 0으로 설정된 경우 ScriptManager는 JavaScriptSerializer 기본 제한을 재정의하지 않습니다.

Example:

    <appSettings>
      <add key="aspnet:UpdatePanelMaxScriptLength" value="0" />
    </appSettings>
aspnet:UseHostHeaderForRequestUrl

Url 속성이 동적으로 빌드되는 방법을 지정합니다. 기본적으로 Url 속성은 호스트, 포트 및 웹 서버에서 제공한 경로에서 동적으로 빌드됩니다.

Type:

Boolean

Default value:

false

Remarks:

value 특성이 false[기본값]인 경우 Url 속성은 호스트, 포트 및 웹 서버에서 제공된 경로에서 동적으로 빌드됩니다. value 특성이 true인 경우 Url 속성은 들어오는 "Host" 헤더에서 제공된 호스트 및 포터 및 웹 서버에서 제공된 경로를 사용하여 동적으로 빌드됩니다.

Example:

    <appSettings>
      <add key="aspnet:UseHostHeaderForRequestUrl" value="false" />
    </appSettings>
aspnet:UseLegacyEncryption

ASP.NET이 암호화된 페이로드를 서명할지 여부를 지정합니다.

Type:

Boolean

Default value:

false

Remarks:

이 키 값이 false[기본값]인 경우 ASP.NET은 암호화된 모든 페이로드를 서명하며 이런 페이로드의 암호를 해독하기 전에 암호화 서명을 확인합니다. 이러한 페이로드의 예로 ViewState, FormsAuth 쿠키 및 ScriptResource.axd URL을 들 수 있습니다. 이 키 값이 true인 경우 ASP.NET은 암호화된 페이로드를 서명하지 않으며 이러한 페이로드의 암호화된 서명을 확인하지 않습니다. EncodeDecode API는 이 스위치의 영향을 받지 않으며 자신만의 고유한 호환성 스위치가 있습니다.

Example:

    <appSettings>
      <add key="aspnet:UseLegacyEncryption" value="false" />
    </appSettings>
주의 정보 주의

이 특성을 true로 설정하면 보안 위험이 발생할 수 있습니다.

aspnet:UseLegacyEventValidationCompatibility

ASP.NET에서 Web Forms 응용 프로그램의 __EVENTVALIDATION 필드에 사용하는 serialization 형식을 지정합니다.

Type:

Boolean

Default value:

false

Remarks:

이 키 값이 false[기본값]인 경우 4.5 이상을 위한 새로운 형식을 사용하여 Web Forms 응용 프로그램의 __EVENTVALIDATION 필드를 serialize합니다. 이 스위치가 true인 경우 __EVENTVALIDATION 필드는 ASP.NET의 이전 버전과 호환되는 serialization 형식을 사용합니다. 이 설정은 .NET 4.5에 대한 웹 팜 배치에서 응용 프로그램을 마이그레이션하는 동안 true로만 설정해야 합니다. 이렇게 하면 4.0을 실행 중인 서버에서 생성한 페이지가 4.5를 실행하는 서버에 게시되거나 그 반대로 되도록 할 수 있습니다. 마이그레이션이 완료되면 이 키가 제거되거나 다시 false로 설정되어야 합니다.

Example:

    <appSettings>
      <add key="aspnet:UseLegacyEventValidationCompatibility" value="false" />
    </appSettings>
aspnet:UseLegacyFormsAuthenticationTicketCompatibility

ASP.NET에서 다음을 수행하는지 여부를 지정합니다.

Type:

Boolean

Default value:

false

Remarks:

이 키 값이 false[기본값]인 경우 ASP.NET은 4.0 serialization 형식을 사용하여 FormsAuth 티켓을 serialize합니다. 이 키 값이 true인 경우 ASP.NET은 이전 serialization 형식을 사용합니다.

Example:

    <appSettings>
      <add key="aspnet:UseLegacyFormsAuthenticationTicketCompatibility" value="false" />
    </appSettings>
주의 정보 주의

이 특성을 true로 설정하면 보안 위험이 발생할 수 있습니다.

aspnet:UseLegacyMachineKeyEncryption

ASP.NET이 MachineKey.Encode API를 통해 암호화된 페이로드를 서명하는지 여부를 지정합니다.

Type:

Boolean

Default value:

false

Remarks:

이 키 값이 false[기본값]인 경우 ASP.NET은 Encode API를 통해 암호화된 모든 페이로드를 서명하며 이러한 페이로드의 암호를 해독하기 전에 암호화 서명을 확인합니다. 이 키 값이 true인 경우 ASP.NET은 Encode API를 통해 암호화된 페이로드를 서명하지 않으며 이러한 페이로드의 암호화 서명을 확인하지 않습니다. ViewState, 폼 인증 및 유사한 상태 관리 영역이 이 키 값의 영향을 받지 않으며 각각 자신만의 고유한 호환성 스위치가 있습니다.

Example:

    <appSettings>
      <add key="aspnet:UseLegacyMachineKeyEncryption" value="false" />
    </appSettings>
주의 정보 주의

이 특성을 true로 설정하면 보안 위험이 발생할 수 있습니다.

aspnet:UseTaskFriendlySynchronizationContext

ASP.NET 4.5의 비동기 코드 경로가 동작하는 방법을 지정합니다.

Type:

Boolean

Default value:

false

Remarks:

이 키 값이 false[기본값]인 경우 ASP.NET 4.5의 비동기 코드 경로는 ASP.NET 4.0에서와 마찬가지로 동작합니다. 이 키 값이 true인 경우 ASP.NET 4.5는 작업 반환 API에 최적화된 코드 경로를 사용합니다. 이 호환성 스위치는 WebSockets 사용 응용 프로그램, Web Forms 페이지의 작업 기반 비동기화 사용 및 기타 특정 비동기 동작에 대해 반드시 설정해야 합니다.

Example:

    <appSettings>
      <add key="aspnet:UseTaskFriendlySynchronizationContext" value="false" />
    </appSettings>
aspnet:MaxAcceptLanguageFallbackCount

HTTP Accept-Language 헤더에서 CultureInfo 개체를 어느 정도로 검색할지를 제어합니다.

Type:

Int32

Default value:

3

Remarks:

예를 들어 기본값 3을 유지하고 Accept 헤더가 "en-us, en, fr-FR, zh-CN"으로 수신하는 경우 ASP.NET은 "en-us", "en" 및 "fr-FR"을 순서대로 검색하지만 이 세 가지 모두 실패하는 경우 "zh-CN"을 검색하지 않습니다.

Example:

    <appSettings>
      <add key="aspnet:MaxAcceptLanguageFallbackCount" value="3" />
    </appSettings>
aspnet:UseLegacyRequestUrlGeneration

현재 요청을 나타내는 HttpRequest.Url의 동작을 제어합니다.

Type:

Boolean

Default value:

false

Remarks:

이 스위치가 false인 경우 ASP.NET 런타임은 ASP.NET 이전 버전보다 효율적인 표준 준수가 있는 Uri를 생성합니다. 이 스위치가 true인 경우 런타임은 이전 버전과 호환되는 Uri를 생성합니다.

Example:

    <appSettings>
      <add key="aspnet:UseLegacyRequestUrlGeneration" value="false" />
    </appSettings>
PageInspector:ServerCodeMappingSupport

Visual Studio에서 페이지 검사기가 활성화되어 있는지 여부를 지정합니다.

Type:

String

Default value:

Disabled

Remarks:

PageInspector:ServerCodeMappingSupport 키 값이 웹 응용 프로그램에서 Enabled로 설정된 경우 페이지 검사기가 활성화됩니다. 단, deployment 요소의 retail 특성이 Machine.config 파일의 <system.web> 섹션에서 true로 설정되어 있는 경우는 제외합니다. retail 특성이 Machine.config 파일에 설정되어 있지 않고 PageInspector:ServerCodeMappingSupport 키 값도 설정되어 있지 않은 경우 디버그 모드에서 페이지 검사기가 활성화되었는지 여부를 확인합니다.

Example:

    <appSettings>
      <add key="PageInspector:ServerCodeMappingSupport" value="Disabled" />
    </appSettings>
ValidationSettings:UnobtrusiveValidationMode

ASP.NET에서 클라이언트 쪽 유효성 검사 논리에 대한 비간섭 JavaScript를 사용하도록 기본 제공 유효성 검사기 컨트롤을 전체적으로 활성화하는 방법을 지정합니다.

Type:

UnobtrusiveValidationMode

Default value:

없음

Remarks:

이 키 값이 "None"[기본값]으로 설정된 경우 ASP.NET 응용 프로그램은 클라이언트 쪽 유효성 검사 논리에 대해 4.5 이전 동작(페이지의 JavaScript 인라인)을 사용합니다. 이 키 값이 "WebForms"로 설정된 경우 ASP.NET은 HTML5 데이터-특성 및 클라이언트 쪽 유효성 검사 논리에 대해 추가된 스크립트 참조의 런타임에 바인딩된 JavaScript를 사용합니다.

Example:

    <appSettings>
      <add key="ValidationSettings:UnobtrusiveValidationMode" value="None" />
    </appSettings>
표시: