IDataObject.GetFormats 메서드

정의

이 인스턴스에 저장된 데이터와 관련되어 있거나 해당 데이터를 변환할 수 있는 모든 형식의 목록을 반환합니다.Returns a list of all formats that data stored in this instance is associated with or can be converted to.

오버로드

GetFormats()

이 인스턴스에 저장된 데이터와 관련되어 있거나 해당 데이터를 변환할 수 있는 모든 형식의 목록을 반환합니다.Returns a list of all formats that data stored in this instance is associated with or can be converted to.

GetFormats(Boolean)

부울 값을 통해 데이터가 변환될 수 있는 모든 형식을 검색할지 또는 네이티브 데이터 형식만 검색할지를 결정하여 이 인스턴스에 저장된 데이터와 관련되어 있거나 해당 데이터를 변환할 수 있는 모든 형식의 목록을 가져옵니다.Gets a list of all formats that data stored in this instance is associated with or can be converted to, using a Boolean value to determine whether to retrieve all formats that the data can be converted to or only native data formats.

GetFormats()

이 인스턴스에 저장된 데이터와 관련되어 있거나 해당 데이터를 변환할 수 있는 모든 형식의 목록을 반환합니다.Returns a list of all formats that data stored in this instance is associated with or can be converted to.

public:
 cli::array <System::String ^> ^ GetFormats();
public string[] GetFormats ();
abstract member GetFormats : unit -> string[]
Public Function GetFormats () As String()

반환

String[]

이 개체에 저장된 데이터가 지원하는 모든 형식의 목록을 나타내는 이름의 배열입니다.An array of the names that represents a list of all formats that are supported by the data stored in this object.

예제

이 예제에서는 합니다 DataObject 클래스를 구현 하는 IDataObject의 사용을 보여 합니다 GetFormats 메서드.This example uses the DataObject class, which implements IDataObject, to demonstrate the use of the GetFormats method. 첫째, 데이터 개체를 만듭니다 (myDataObject) 문자열을 사용 하 고 Text 형식입니다.First, it creates a data object (myDataObject) using a string and the Text format. 그런 다음 모든 데이터 형식 및 데이터 개체의 데이터 변환 형식 검색 하 고 메시지 상자에 결과 목록이 표시 됩니다.Then it retrieves all the data formats and data conversion formats in the data object, and displays the resulting list in a message box. 이 예에서는 만들었다고 가정 된 Form 라는 Form1합니다.This example assumes that you have created a Form named Form1.

private:
   void GetFormats1()
   {
      // Creates a data object using a string and the Text format.
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,"My text string" );
      
      // Gets all the data formats and data conversion formats in the data object.
      array<String^>^allFormats = myDataObject->GetFormats();
      
      // Creates the string that contains the formats.
      String^ theResult = "The format(s) associated with the data are: \n";
      for ( int i = 0; i < allFormats->Length; i++ )
         theResult = theResult + allFormats[ i ] + "\n";
      
      // Displays the result in a message box.
      MessageBox::Show( theResult );
   }
private void GetFormats1() 
{
    // Creates a data object using a string and the Text format.
    DataObject myDataObject = new DataObject(DataFormats.Text, "My text string");
 
    // Gets all the data formats and data conversion formats in the data object.
    String[] allFormats = myDataObject.GetFormats();

    // Creates the string that contains the formats.
    string theResult = "The format(s) associated with the data are: " + '\n';
    for(int i = 0; i < allFormats.Length; i++)
        theResult += allFormats[i] + '\n';
    // Displays the result in a message box.
    MessageBox.Show(theResult);
}
Private Sub GetFormats1()
   ' Creates a data object using a string and the Text format.
   Dim myDataObject As New DataObject(DataFormats.Text, "My text string")
   
   ' Gets all the data formats and data conversion formats in the data object.
   Dim allFormats As [String]() = myDataObject.GetFormats()
   
   ' Creates the string that contains the formats.
   Dim theResult As String = "The format(s) associated with the data are: " & _
                vbCr
   Dim i As Integer
   For i = 0 To allFormats.Length - 1
      theResult += allFormats(i) + vbCr
   Next i 
   ' Displays the result in a message box.
   MessageBox.Show(theResult)
End Sub

설명

이 메서드를 호출 하기 전에 지원 되는 데이터 형식을 가져오려고 합니다 GetData 메서드.Call this method to get the supported data formats before calling the GetData method. 참조 된 DataFormats 미리 정의 된 형식에 대 한 클래스입니다.See the DataFormats class for the predefined formats.

참고

데이터는 변환이 가능 하도록 지정 합니다. 저장 된 경우 및 요청된 된 형식으로 저장 된 형식과 호환 되는 경우 다른 형식으로 변환할 수 있습니다.Data can be converted to another format if it was stored specifying that conversion is allowed, and if the requested format is compatible with the stored format. 유니코드 텍스트로 변환할 수로 저장 된 데이터 예For example, data stored as Unicode can be converted to text.

이 메서드를 구현 하는 것을 참조 하세요. DataObject.GetFormats합니다.For an implementation of this method, see DataObject.GetFormats.

추가 정보

GetFormats(Boolean)

부울 값을 통해 데이터가 변환될 수 있는 모든 형식을 검색할지 또는 네이티브 데이터 형식만 검색할지를 결정하여 이 인스턴스에 저장된 데이터와 관련되어 있거나 해당 데이터를 변환할 수 있는 모든 형식의 목록을 가져옵니다.Gets a list of all formats that data stored in this instance is associated with or can be converted to, using a Boolean value to determine whether to retrieve all formats that the data can be converted to or only native data formats.

public:
 cli::array <System::String ^> ^ GetFormats(bool autoConvert);
public string[] GetFormats (bool autoConvert);
abstract member GetFormats : bool -> string[]
Public Function GetFormats (autoConvert As Boolean) As String()

매개 변수

autoConvert
Boolean

이 인스턴스에 저장된 데이터와 관련되어 있거나 해당 데이터를 변환할 수 있는 모든 형식을 검색하려면 true이고, 네이티브 데이터 형식만 검색하려면 false입니다.true to retrieve all formats that data stored in this instance is associated with or can be converted to; false to retrieve only native data formats.

반환

String[]

이 개체에 저장된 데이터가 지원하는 모든 형식의 목록을 나타내는 이름의 배열입니다.An array of the names that represents a list of all formats that are supported by the data stored in this object.

예제

이 예제에서는 합니다 DataObject 클래스를 구현 하는 IDataObject의 사용을 보여 합니다 GetFormats 메서드.This example uses the DataObject class, which implements IDataObject, to demonstrate the use of the GetFormats method. 첫째, 데이터 개체를 만듭니다 (myDataObject) 문자열을 사용 하 고 UnicodeText 형식입니다.First, it creates a data object (myDataObject) using a string and the UnicodeText format. 다음 두 쿼리를 데이터와 관련 된 형식을 가져올 수 있습니다.Then it makes two queries to get the formats associated with the data. 첫 번째 쿼리에서 설정 합니다 autoConvert 매개 변수를 false :이 경우 데이터의 네이티브 형식에만 반환 됩니다.In the first query, it sets the autoConvert parameter to false : in this case, only the native format of the data is returned. 두 번째 쿼리에서 설정 합니다 autoConvert 매개 변수를 true는 데이터를 변환할 수 있는 형식을 포함 하는 형식 목록을 가져옵니다.In the second query, it sets the autoConvert parameter to true, so that it gets the list of formats, including the formats that the data can be converted to. 각각의 경우에서 메시지 상자에 결과 목록이 표시 됩니다.In each case, the resulting list is displayed in a message box. 이 예에서는 만들었다고 가정 된 Form 라는 Form1합니다.This example assumes that you have created a Form named Form1.

private:
   void GetFormats2()
   {
      // Creates a new data object using a string and the UnicodeText format.
      DataObject^ myDataObject = gcnew DataObject( DataFormats::UnicodeText,"My text string" );
      
      // Gets the original data formats in the data object by setting the automatic
      // conversion parameter to false.
      array<String^>^myFormatsArray = myDataObject->GetFormats( false );
      
      // Stores the results in a string.
      String^ theResult = "The original format associated with the data is:\n";
      for ( int i = 0; i < myFormatsArray->Length; i++ )
         theResult = theResult + myFormatsArray[ i ] + "\n";
      
      // Gets all data formats and data conversion formats for the data object.
      myFormatsArray = myDataObject->GetFormats( true );
      
      // Stores the results in the string.
      theResult = theResult + "\nThe data format(s) and conversion format(s) associated with the data are:\n";
      for ( int i = 0; i < myFormatsArray->Length; i++ )
         theResult = theResult + myFormatsArray[ i ] + "\n";
      
      // Displays the results.
      MessageBox::Show( theResult );
   }
private void GetFormats2() 
{
    // Creates a new data object using a string and the UnicodeText format.
    DataObject myDataObject = new DataObject(DataFormats.UnicodeText, "My text string");

    // Gets the original data formats in the data object by setting the automatic
    // conversion parameter to false.
    String[] myFormatsArray = myDataObject.GetFormats(false);

    // Stores the results in a string.
    string theResult = "The original format associated with the data is:\n";
    for(int i = 0; i < myFormatsArray.Length; i++)
        theResult += myFormatsArray[i] + '\n';

    // Gets all data formats and data conversion formats for the data object.
    myFormatsArray = myDataObject.GetFormats(true);
 
    // Stores the results in the string.
    theResult += "\nThe data format(s) and conversion format(s) associated with " +
        "the data are:\n";
    for(int i = 0; i < myFormatsArray.Length; i++)
        theResult += myFormatsArray[i] + '\n';

    // Displays the results.
    MessageBox.Show(theResult);
}
Private Sub GetFormats2()
   ' Creates a new data object using a string and the UnicodeText format.
   Dim myDataObject As New DataObject(DataFormats.UnicodeText, "My text string")
   
   ' Gets the original data formats in the data object by setting the automatic
   ' conversion parameter to false.
   Dim myFormatsArray As [String]() = myDataObject.GetFormats(False)
   
   ' Stores the results in a string.
   Dim theResult As String = "The original format associated with the data is:" & vbCr
   Dim i As Integer
   For i = 0 To myFormatsArray.Length - 1
      theResult += myFormatsArray(i) + vbCr
   Next i 
   ' Gets all data formats and data conversion formats for the data object.
   myFormatsArray = myDataObject.GetFormats(True)
   
   ' Stores the results in the string.
   theResult += vbCr + "The data format(s) and conversion format(s) associated with " & _
     "the data are:" & vbCr
   For i = 0 To myFormatsArray.Length - 1
      theResult += myFormatsArray(i) + vbCr
   Next i
   ' Displays the results.
   MessageBox.Show(theResult)
End Sub

설명

이 메서드를 호출 하기 전에 지원 되는 데이터 형식을 가져오려고 합니다 GetData 메서드.Call this method to get the supported data formats before calling the GetData method. 참조 된 DataFormats 미리 정의 된 형식에 대 한 클래스입니다.See the DataFormats class for the predefined formats.

참고

데이터는 변환이 가능 하도록 지정 합니다. 저장 된 경우 및 요청된 된 형식으로 저장 된 형식과 호환 되는 경우 다른 형식으로 변환할 수 있습니다.Data can be converted to another format if it was stored specifying that conversion is allowed, and if the requested format is compatible with the stored format. 유니코드 텍스트로 변환할 수로 저장 된 데이터 예For example, data stored as Unicode can be converted to text.

이 메서드를 구현 하는 것을 참조 하세요. DataObject.GetFormats합니다.For an implementation of this method, see DataObject.GetFormats.

추가 정보

적용 대상