다음을 통해 공유


DataObject.GetData 메서드

정의

지정된 데이터 서식의 데이터를 반환합니다.

오버로드

GetData(String)

문자열로 지정된 형식의 데이터를 반환합니다.

GetData(Type)

Type 개체로 지정된 형식의 데이터 개체를 반환합니다.

GetData(String, Boolean)

지정된 형식의 데이터 개체를 반환하고 선택적으로 데이터를 지정된 형식으로 변환합니다.

GetData(String)

문자열로 지정된 형식의 데이터를 반환합니다.

public:
 virtual System::Object ^ GetData(System::String ^ format);
public object GetData (string format);
abstract member GetData : string -> obj
override this.GetData : string -> obj
Public Function GetData (format As String) As Object

매개 변수

format
String

데이터 서식을 지정하는 문자열입니다. 미리 정의된 데이터 형식 집합은 DataFormats 클래스를 참조하세요.

반환

Object

지정된 형식의 데이터가 들어 있는 개체이거나, 지정된 형식의 데이터가 없으면 null입니다.

구현

예외

format이(가) null인 경우

예제

다음 예제에서는 이 메서드를 사용하여 먼저 지정된 데이터 형식을 사용할 수 있는지(기본적으로 또는 자동 변환에 의해) 확인할 수 있습니다. 지정된 형식을 사용할 수 있으면 이 예제에서는 메서드를 사용하여 GetData(String) 데이터를 검색합니다.

DataObject dataObject = new DataObject("Some string data to store...");

string desiredFormat = DataFormats.UnicodeText;
byte[] data = null;

// Use the GetDataPresent method to check for the presence of a desired data format.
// This particular overload of GetDataPresent looks for both native and auto-convertible 
// data formats.
if (dataObject.GetDataPresent(desiredFormat))
{
    // If the desired data format is present, use one of the GetData methods to retrieve the
    // data from the data object.
    data = dataObject.GetData(desiredFormat) as byte[];
}
Dim dataObject As New DataObject("Some string data to store...")

Dim desiredFormat As String = DataFormats.UnicodeText
Dim data() As Byte = Nothing

' Use the GetDataPresent method to check for the presence of a desired data format.
' This particular overload of GetDataPresent looks for both native and auto-convertible 
' data formats.
If dataObject.GetDataPresent(desiredFormat) Then
    ' If the desired data format is present, use one of the GetData methods to retrieve the
    ' data from the data object.
    data = TryCast(dataObject.GetData(desiredFormat), Byte())
End If

다음 예제 코드에서는 먼저 메서드를 사용하여 GetDataPresent(String, Boolean) 지정된 데이터 형식을 기본적으로 사용할 수 있는지 확인합니다(자동 변환 가능한 데이터 형식이 필터링됨). 지정된 형식을 사용할 수 있는 경우 이 메서드를 사용하여 GetData(String) 데이터를 검색합니다.

DataObject dataObject = new DataObject("Some string data to store...");

string desiredFormat = DataFormats.UnicodeText;
bool noAutoConvert = false;
byte[] data = null;

// Use the GetDataPresent method to check for the presence of a desired data format.
// The autoconvert parameter is set to false to filter out auto-convertible data formats,
// returning true only if the specified data format is available natively.
if (dataObject.GetDataPresent(desiredFormat, noAutoConvert))
{
    // If the desired data format is present, use one of the GetData methods to retrieve the
    // data from the data object.
    data = dataObject.GetData(desiredFormat) as byte[];
}
Dim dataObject As New DataObject("Some string data to store...")

Dim desiredFormat As String = DataFormats.UnicodeText
Dim noAutoConvert As Boolean = False
Dim data() As Byte = Nothing

' Use the GetDataPresent method to check for the presence of a desired data format.
' The autoconvert parameter is set to false to filter out auto-convertible data formats,
' returning true only if the specified data format is available natively.
If dataObject.GetDataPresent(desiredFormat, noAutoConvert) Then
    ' If the desired data format is present, use one of the GetData methods to retrieve the
    ' data from the data object.
    data = TryCast(dataObject.GetData(desiredFormat), Byte())
End If

추가 정보

적용 대상

GetData(Type)

Type 개체로 지정된 형식의 데이터 개체를 반환합니다.

public:
 virtual System::Object ^ GetData(Type ^ format);
public object GetData (Type format);
abstract member GetData : Type -> obj
override this.GetData : Type -> obj
Public Function GetData (format As Type) As Object

매개 변수

format
Type

데이터 서식을 지정하는 Type입니다. 미리 정의된 데이터 형식 집합은 DataFormats 클래스를 참조하세요.

반환

Object

지정된 형식의 데이터가 들어 있는 데이터 개체이거나, 지정된 형식의 데이터가 없으면 null입니다.

구현

예외

format이(가) null인 경우

추가 정보

적용 대상

GetData(String, Boolean)

지정된 형식의 데이터 개체를 반환하고 선택적으로 데이터를 지정된 형식으로 변환합니다.

public:
 virtual System::Object ^ GetData(System::String ^ format, bool autoConvert);
public object GetData (string format, bool autoConvert);
abstract member GetData : string * bool -> obj
override this.GetData : string * bool -> obj
Public Function GetData (format As String, autoConvert As Boolean) As Object

매개 변수

format
String

데이터 서식을 지정하는 문자열입니다. 미리 정의된 데이터 형식 집합은 DataFormats 클래스를 참조하세요.

autoConvert
Boolean

데이터를 지정된 형식으로 자동 변환하려면 true이고, 데이터를 변환하지 않으려면 false입니다.

반환

Object

지정된 형식의 데이터가 들어 있는 데이터 개체이거나, 지정된 형식의 데이터가 없으면 null입니다.

autoConvert 매개 변수가 true이고 데이터를 지정된 형식으로 변환할 수 없거나, autoConvert 매개 변수를 false로 설정하고 SetData(String, Object, Boolean)를 호출하여 자동 변환이 사용되지 않는 경우 이 메서드는 null을 반환합니다.

구현

예외

formatnull 인 경우

추가 정보

적용 대상