ScriptMethodAttribute 클래스

정의

네임스페이스:

System.Web.Script.Services

어셈블리:

System.Web.Extensions.dll

메서드를 호출하는 데 사용되는 HTTP 동사와 응답 형식을 지정합니다. 이 클래스는 상속할 수 없습니다.

public ref class ScriptMethodAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Method)]
public sealed class ScriptMethodAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Method)>]
type ScriptMethodAttribute = class
    inherit Attribute

Public NotInheritable Class ScriptMethodAttribute
Inherits Attribute

상속

Object

Attribute

ScriptMethodAttribute

특성

AttributeUsageAttribute

예제

다음 예제에서는 사용할 HTTP 동사를 지정하고 EchoStringAndDate 응답 형식을 지정하기 위해 메서드 및 메서드에 적용 ScriptMethodAttributeGetXmlDocument 하는 방법을 보여 줍니다.

설명

이 특성은 클라이언트 스크립트에서 호출할 수 있는 메서드에 대한 정보를 지정하는 데 사용됩니다. 이 특성을 사용하면 메서드를 호출하는 데 사용할 수 있는 HTTP 동사(GET 또는 POST)를 지정할 수 있습니다. 또한 JSON(JavaScript Object Notation) 또는 XML을 사용하여 응답의 형식을 지정할 수도 있습니다.

ScriptMethodAttribute 특성은 선택 사항입니다. 그러나 클라이언트 스크립트에서 호출할 수 있는 메서드에는 특성이 System.Web.Services.WebMethodAttribute 적용되어야 합니다. 메서드가 표시되지 ScriptMethodAttribute않으면 HTTP POST 명령을 사용하여 메서드가 호출되고 응답이 JSON으로 serialize됩니다. 스크립트에서 이 설정을 재정의할 수 없습니다.

ScriptMethodAttribute 는 명명된 매개 변수만 사용합니다. 다음은 명명된 매개 변수로 사용할 수 있는 클래스의 ScriptMethodAttribute 속성입니다.

• UseHttpGet

  HTTP GET 명령을 사용하여 메서드를 호출할지 여부를 지정합니다. 기본값은 false입니다.

  중요합니다

  UseHttpGet 중요한 데이터 또는 트랜잭션을 사용하는 경우 속성을 true 설정하면 애플리케이션에 보안 위험이 발생할 수 있습니다. GET 요청에서 메시지는 브라우저에서 URL로 인코딩되므로 변조를 위한 더 쉬운 대상입니다. GET 및 POST 요청 모두에 대해 중요한 데이터를 보호하려면 보안 지침을 따라야 합니다.

• ResponseFormat

  응답을 JSON 또는 XML로 serialize할지 여부를 지정합니다. 기본값은 Json입니다. 이 ResponseFormat 속성은 메서드가 개체를 반환할 때 XML을 반환 형식으로 지정하는 XmlDocumentXmlElement 데 유용합니다.

• XmlSerializeString

  문자열 형식을 포함한 모든 반환 형식이 XML로 serialize되는지 여부를 지정합니다. 응답이 XmlSerializeString JSON으로 serialize되면 속성 값이 무시됩니다.

특성을 사용하는 방법에 대한 자세한 내용은 특성을 참조하세요.

생성자

Name	Description
ScriptMethodAttribute()	ScriptMethodAttribute 클래스의 새 인스턴스를 초기화합니다.

속성

Name	Description
ResponseFormat	메서드 응답의 형식을 가져오거나 설정합니다.
TypeId	파생 클래스에서 구현되는 경우 이 Attribute대한 고유 식별자를 가져옵니다. (다음에서 상속됨 Attribute)
UseHttpGet	HTTP GET을 사용하여 메서드를 호출할지 여부를 나타내는 값을 가져오거나 설정합니다.
XmlSerializeString	모든 반환 형식이 문자열 형식을 포함하는 XML로 serialize되는지 여부를 나타내는 값을 가져오거나 설정합니다.

메서드

Name	Description
Equals(Object)	이 인스턴스가 지정된 개체와 같은지 여부를 나타내는 값을 반환합니다. (다음에서 상속됨 Attribute)
GetHashCode()	이 인스턴스의 해시 코드를 반환합니다. (다음에서 상속됨 Attribute)
GetType()	현재 인스턴스의 Type 가져옵니다. (다음에서 상속됨 Object)
IsDefaultAttribute()	파생 클래스에서 재정의되는 경우 이 인스턴스의 값이 파생 클래스의 기본값인지 여부를 나타냅니다. (다음에서 상속됨 Attribute)
Match(Object)	파생 클래스에서 재정의되는 경우 이 인스턴스가 지정된 개체와 같은지 여부를 나타내는 값을 반환합니다. (다음에서 상속됨 Attribute)
MemberwiseClone()	현재 Object단순 복사본을 만듭니다. (다음에서 상속됨 Object)
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)

명시적 인터페이스 구현

Name	Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	이름 집합을 해당하는 디스패치 식별자 집합에 매핑합니다. (다음에서 상속됨 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	인터페이스의 형식 정보를 가져오는 데 사용할 수 있는 개체의 형식 정보를 검색합니다. (다음에서 상속됨 Attribute)
_Attribute.GetTypeInfoCount(UInt32)	개체에서 제공하는 형식 정보 인터페이스의 수를 검색합니다(0 또는 1). (다음에서 상속됨 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	개체에 의해 노출되는 속성 및 메서드에 대한 액세스를 제공합니다. (다음에서 상속됨 Attribute)

추가 정보

• WebMethodAttribute
• ASP.NET AJAX에서 웹 서비스 사용
• ASP.NET AJAX에서 클라이언트 스크립트에 웹 서비스 노출
• ASP.NET AJAX의 클라이언트 스크립트에서 웹 서비스 호출