DataObject.GetDataPresent 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
지정된 형식의 데이터가 있거나 지정된 형식으로 변환될 수 있는지 확인합니다.
오버로드
| GetDataPresent(String) |
문자열로 지정된 형식의 데이터가 있거나 지정된 형식으로 변환될 수 있는지 확인합니다. |
| GetDataPresent(Type) |
Type 개체로 지정된 형식의 데이터가 있거나 지정된 형식으로 변환될 수 있는지 확인합니다. |
| GetDataPresent(String, Boolean) |
지정된 형식의 데이터가 있거나 지정된 형식으로 변환될 수 있는지 확인합니다. |
설명
호출하기 전에 이 데이터 개체에서 형식을 사용할 수 있는지 여부를 확인하려면 호출 GetDataPresent GetData합니다. 이 데이터 개체에서 사용할 수 있는 모든 형식의 목록을 가져오려면 호출 GetFormats 합니다.
GetDataPresent(String)
문자열로 지정된 형식의 데이터가 있거나 지정된 형식으로 변환될 수 있는지 확인합니다.
public:
virtual bool GetDataPresent(System::String ^ format);public bool GetDataPresent (string format);abstract member GetDataPresent : string -> bool
override this.GetDataPresent : string -> boolPublic Function GetDataPresent (format As String) As Boolean매개 변수
- format
- String
데이터 서식을 지정하는 문자열입니다. 미리 정의된 데이터 형식 집합은 DataFormats 클래스를 참조하세요.
반환
데이터가 지정된 형식이거나 지정된 형식으로 변환할 수 있으면 true이고, 그렇지 않으면 false입니다.
구현
예외
format이(가) null인 경우
예제
다음 예제에서는 이 메서드를 사용하여 설명자 문자열로 특정 데이터 형식이 있는지 쿼리합니다.
DataObject dataObject = new DataObject("Some string data to store...");
// Query for the presence of Text data in the data object, by a data format descriptor string.
// In this overload of GetDataPresent, the method will return true both for native data formats
// and when the data can automatically be converted to the specifed format.
// In this case, string data is present natively, so GetDataPresent returns "true".
string textData = null;
if (dataObject.GetDataPresent(DataFormats.StringFormat))
{
textData = dataObject.GetData(DataFormats.StringFormat) as string;
}
// In this case, the Text data in the data object can be autoconverted to
// Unicode text, so GetDataPresent returns "true".
byte[] unicodeData = null;
if (dataObject.GetDataPresent(DataFormats.UnicodeText))
{
unicodeData = dataObject.GetData(DataFormats.UnicodeText) as byte[];
}
Dim dataObject As New DataObject("Some string data to store...")
' Query for the presence of Text data in the data object, by a data format descriptor string.
' In this overload of GetDataPresent, the method will return true both for native data formats
' and when the data can automatically be converted to the specifed format.
' In this case, string data is present natively, so GetDataPresent returns "true".
Dim textData As String = Nothing
If dataObject.GetDataPresent(DataFormats.StringFormat) Then
textData = TryCast(dataObject.GetData(DataFormats.StringFormat), String)
End If
' In this case, the Text data in the data object can be autoconverted to
' Unicode text, so GetDataPresent returns "true".
Dim unicodeData() As Byte = Nothing
If dataObject.GetDataPresent(DataFormats.UnicodeText) Then
unicodeData = TryCast(dataObject.GetData(DataFormats.UnicodeText), Byte())
End If
설명
호출하기 전에 이 데이터 개체에서 형식을 사용할 수 있는지 여부를 확인하려면 호출 GetDataPresent GetData합니다. 이 데이터 개체에서 사용할 수 있는 모든 형식의 목록을 가져오려면 호출 GetFormats 합니다.
추가 정보
적용 대상
GetDataPresent(Type)
Type 개체로 지정된 형식의 데이터가 있거나 지정된 형식으로 변환될 수 있는지 확인합니다.
public:
virtual bool GetDataPresent(Type ^ format);public bool GetDataPresent (Type format);abstract member GetDataPresent : Type -> bool
override this.GetDataPresent : Type -> boolPublic Function GetDataPresent (format As Type) As Boolean매개 변수
- format
- Type
확인할 데이터 서식을 지정하는 Type입니다. 미리 정의된 데이터 서식 집합은 DataFormats 클래스를 참조하십시오.
반환
데이터가 지정된 형식이거나 지정된 형식으로 변환할 수 있으면 true이고, 그렇지 않으면 false입니다.
구현
예외
format이(가) null인 경우
예제
다음 예제에서는 이 메서드를 사용하여 형식별 특정 데이터 형식의 존재를 쿼리합니다.
DataObject dataObject = new DataObject("Some string data to store...");
// Query for the presence of String data in the data object, by type. In this overload
// of GetDataPresent, the method will return true both for native data formats
// and when the data can automatically be converted to the specifed format.
// In this case, the Text data present in the data object can be autoconverted
// to type string (also represented by DataFormats.String), so GetDataPresent returns "true".
string stringData = null;
if (dataObject.GetDataPresent(typeof(string)))
{
stringData = dataObject.GetData(DataFormats.Text) as string;
}
Dim dataObject As New DataObject("Some string data to store...")
' Query for the presence of String data in the data object, by type. In this overload
' of GetDataPresent, the method will return true both for native data formats
' and when the data can automatically be converted to the specifed format.
' In this case, the Text data present in the data object can be autoconverted
' to type string (also represented by DataFormats.String), so GetDataPresent returns "true".
Dim stringData As String = Nothing
If dataObject.GetDataPresent(GetType(String)) Then
stringData = TryCast(dataObject.GetData(DataFormats.Text), String)
End If
설명
호출하기 전에 이 데이터 개체에서 형식을 사용할 수 있는지 여부를 확인하려면 호출 GetDataPresent GetData합니다. 이 데이터 개체에서 사용할 수 있는 모든 형식의 목록을 가져오려면 호출 GetFormats 합니다.
추가 정보
적용 대상
GetDataPresent(String, Boolean)
지정된 형식의 데이터가 있거나 지정된 형식으로 변환될 수 있는지 확인합니다. Boolean 플래그는 지정된 형식의 데이터가 없는 경우 데이터를 해당 형식으로 변환할 수 있는지 확인할지 여부를 나타냅니다.
public:
virtual bool GetDataPresent(System::String ^ format, bool autoConvert);public bool GetDataPresent (string format, bool autoConvert);abstract member GetDataPresent : string * bool -> bool
override this.GetDataPresent : string * bool -> boolPublic Function GetDataPresent (format As String, autoConvert As Boolean) As Boolean매개 변수
- format
- String
확인할 데이터 서식을 지정하는 문자열입니다. 미리 정의된 데이터 형식 집합은 DataFormats 클래스를 참조하세요.
- autoConvert
- Boolean
지정된 형식만 확인하려면 false이고, 이 데이터 개체에 저장된 데이터를 지정된 형식으로 변환할 수 있는지 확인하려면 true입니다.
반환
데이터가 지정된 형식이거나 지정된 형식으로 변환할 수 있으면 true이고, 그렇지 않으면 false입니다.
구현
예외
format이(가) null인 경우
예제
다음 예제에서는 이 메서드를 사용하여 설명자 문자열로 데이터를 쿼리하고 자동 변환 가능한 데이터 형식을 처리하는 방법을 지정합니다.
DataObject dataObject = new DataObject("Some string data to store...");
// Query for the presence of Text data in the data object, by data format descriptor string,
// and specifying whether auto-convertible data formats are acceptable.
// In this case, Text data is present natively, so GetDataPresent returns "true".
string textData = null;
if (dataObject.GetDataPresent(DataFormats.Text, false /* Auto-convert? */))
{
textData = dataObject.GetData(DataFormats.Text) as string;
}
// In this case, the Text data in the data object can be autoconverted to
// Unicode text, but it is not available natively, so GetDataPresent returns "false".
byte[] unicodeData = null;
if (dataObject.GetDataPresent(DataFormats.UnicodeText, false /* Auto-convert? */))
{
unicodeData = dataObject.GetData(DataFormats.UnicodeText) as byte[];
}
// In this case, the Text data in the data object can be autoconverted to
// Unicode text, so GetDataPresent returns "true".
if (dataObject.GetDataPresent(DataFormats.UnicodeText, true /* Auto-convert? */))
{
unicodeData = dataObject.GetData(DataFormats.UnicodeText) as byte[];
}
Dim dataObject As New DataObject("Some string data to store...")
' Query for the presence of Text data in the data object, by data format descriptor string,
' and specifying whether auto-convertible data formats are acceptable.
' In this case, Text data is present natively, so GetDataPresent returns "true".
Dim textData As String = Nothing
If dataObject.GetDataPresent(DataFormats.Text, False) Then ' Auto-convert?
textData = TryCast(dataObject.GetData(DataFormats.Text), String)
End If
' In this case, the Text data in the data object can be autoconverted to
' Unicode text, but it is not available natively, so GetDataPresent returns "false".
Dim unicodeData() As Byte = Nothing
If dataObject.GetDataPresent(DataFormats.UnicodeText, False) Then ' Auto-convert?
unicodeData = TryCast(dataObject.GetData(DataFormats.UnicodeText), Byte())
End If
' In this case, the Text data in the data object can be autoconverted to
' Unicode text, so GetDataPresent returns "true".
If dataObject.GetDataPresent(DataFormats.UnicodeText, True) Then ' Auto-convert?
unicodeData = TryCast(dataObject.GetData(DataFormats.UnicodeText), Byte())
End If
설명
호출하기 전에 이 데이터 개체에서 형식을 사용할 수 있는지 여부를 확인하려면 호출 GetDataPresent GetData합니다. 이 데이터 개체에서 사용할 수 있는 모든 형식의 목록을 가져오려면 호출 GetFormats 합니다.