DefaultParameterValueAttribute 클래스

정의

네임스페이스:

System.Runtime.InteropServices

어셈블리:

System.Runtime.InteropServices.dll

Source:

DefaultParameterValueAttribute.cs

기본 매개 변수를 지원하는 언어에서 호출할 경우 매개 변수의 기본값을 설정합니다. 이 클래스는 상속될 수 없습니다.

public ref class DefaultParameterValueAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Parameter)]
public sealed class DefaultParameterValueAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Parameter)>]
type DefaultParameterValueAttribute = class
    inherit Attribute

Public NotInheritable Class DefaultParameterValueAttribute
Inherits Attribute

상속

Object

Attribute

DefaultParameterValueAttribute

특성

AttributeUsageAttribute

예제

다음 코드 예제에서는 C#으로 작성된 메서드의 매개 변수에 특성을 적용 DefaultParameterValueAttribute 하는 방법을 보여 줍니다. 또한 코드 조각은 특성을 사용하여 OptionalAttribute 인수 없이 메서드를 호출할 수 있도록 합니다.

using System;
using System.Runtime.InteropServices;

public class Program
{
    public static void MethodWithDefaultParam([Optional, DefaultParameterValue("DEFAULT_PARAM_VALUE")] string str)
    {
        Console.WriteLine($"The passed value is: {str}");
    }

    public static void Main()
    {
        MethodWithDefaultParam(); // The passed value is: DEFAULT_PARAM_VALUE
        MethodWithDefaultParam("NEW_VALUE"); // The passed value is: NEW_VALUE
    }    
}

C# 선택적 인수와 와 함께 OptionalAttribute를 사용하는 DefaultParameterValueAttribute 경우 사이에는 몇 가지 동작 차이가 있습니다. 다음 코드 조각은 이러한 차이점을 보여 줍니다.

using System.Runtime.InteropServices;

public class Program
{
    public static void MethodWithObjectDefaultAttr1([Optional, DefaultParameterValue(123)] object obj) {} // OK
    public static void MethodWithObjectDefaultAttr2([Optional, DefaultParameterValue("abc")] object obj) {} // OK
    public static void MethodWithObjectDefaultAttr3([Optional, DefaultParameterValue(null)] object? obj) {} // OK

    public static void MethodWithObjectDefaultParam1(object obj = 123) {} // CS1763
    public static void MethodWithObjectDefaultParam2(object obj = "abc") {} // CS1763
    public static void MethodWithObjectDefaultParam3(object obj? = null) {} // OK
}

설명

DefaultParameterValueAttribute 특성을 사용하면 기본 매개 변수를 지원하지 않는 언어로 기본 매개 변수 값을 지정할 수 있습니다. 이 특성을 코드에 적용한 후 기본 매개 변수를 지원하는 언어는 지정된 값을 기본 매개 변수로 사용할 수 있습니다.

는 DefaultParameterValueAttribute COM interop 인터페이스의 메서드에 대한 기본 매개 변수를 지정하는 데 특히 유용합니다.

생성자

DefaultParameterValueAttribute(Object)

매개 변수 기본값을 사용하여 DefaultParameterValueAttribute 클래스의 새 인스턴스를 초기화합니다.

속성

TypeId	파생 클래스에서 구현된 경우 이 Attribute에 대한 고유 식별자를 가져옵니다. (다음에서 상속됨 Attribute)
Value	매개 변수의 기본값을 가져옵니다.

메서드

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