DataObject.GetFormats 메서드

정의

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

오버로드

GetFormats()

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

GetFormats(Boolean)

자동 변환 매개 변수를 사용하여 네이티브 데이터 형식만 검색할지 아니면 데이터가 변환될 수 있는 모든 형식을 검색할지를 결정하여 이 DataObject에 저장된 데이터가 관련되어 있거나 변환될 수 있는 모든 형식의 목록을 반환합니다.Returns a list of all formats that data stored in this DataObject is associated with or can be converted to, using an automatic conversion parameter to determine whether to retrieve only native data formats or all formats that the data can be converted to.

GetFormats()

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

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

반환

String[]

이 개체에 저장된 데이터가 지원하는 모든 형식의 목록을 포함하는 String 형식의 배열입니다.An array of type String, containing a list of all formats that are supported by the data stored in this object.

구현

예제

다음 코드 예제에서는 해당 데이터와 연결 된 형식과 데이터를 변환할 수 있는 형식에 대 한 DataObject를 쿼리 합니다.The following code example queries a DataObject for the formats associated with its data, and the formats that the data can be converted to. 결과 목록이 텍스트 상자에 표시 됩니다.The resulting list is displayed in a text box. 이 코드를 실행 하려면 textBox1 만들었습니다.This code requires that textBox1 has been created.

private:
   void GetAllFormats()
   {
      // Creates a new data object using a string and the text format.
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,"Another string" );
      
      // Gets all the data formats and data conversion formats in the DataObject.
      array<String^>^ arrayOfFormats = myDataObject->GetFormats();
      
      // Prints the results.
      textBox1->Text = "The format(s) associated with the data are: \n";
      for ( int i = 0; i < arrayOfFormats->Length; i++ )
      {
         textBox1->Text = String::Concat( textBox1->Text, arrayOfFormats[ i ], "\n" );
      }
   }
private void GetAllFormats() {
    // Creates a new data object using a string and the text format.
    DataObject myDataObject = new DataObject(DataFormats.Text, "Another string");
 
    // Gets all the data formats and data conversion formats in the DataObject.
    String[] arrayOfFormats = myDataObject.GetFormats();
 
    // Prints the results.
    textBox1.Text = "The format(s) associated with the data are: " + '\n';
    for(int i=0; i<arrayOfFormats.Length; i++)
       textBox1.Text += arrayOfFormats[i] + '\n';
 }
 
Private Sub GetAllFormats()
    ' Creates a new data object using a string and the text format.
    Dim myDataObject As New DataObject(DataFormats.Text, "Another string")
    
    ' Gets all the data formats and data conversion formats in the DataObject.
    Dim arrayOfFormats As String() = myDataObject.GetFormats()
    
    ' Prints the results.
    textBox1.Text = "The format(s) associated with the data are: " & ControlChars.Cr
    Dim i As Integer
    For i = 0 To arrayOfFormats.Length - 1
        textBox1.Text += arrayOfFormats(i) & ControlChars.Cr
    Next i
End Sub

설명

GetData를 호출 하기 전에이 메서드를 호출 하 여 지원 되는 데이터 형식을 가져옵니다.Call this method to get the supported data formats before calling GetData. 미리 정의 된 형식에 대 한 DataFormats를 참조 하세요.See DataFormats 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.

추가 정보

GetFormats(Boolean)

자동 변환 매개 변수를 사용하여 네이티브 데이터 형식만 검색할지 아니면 데이터가 변환될 수 있는 모든 형식을 검색할지를 결정하여 이 DataObject에 저장된 데이터가 관련되어 있거나 변환될 수 있는 모든 형식의 목록을 반환합니다.Returns a list of all formats that data stored in this DataObject is associated with or can be converted to, using an automatic conversion parameter to determine whether to retrieve only native data formats or all formats that the data can be converted to.

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

매개 변수

autoConvert
Boolean

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

반환

String[]

이 개체에 저장된 데이터가 지원하는 모든 형식의 목록을 포함하는 String 형식의 배열입니다.An array of type String, containing a list of all formats that are supported by the data stored in this object.

구현

예제

다음 코드 예제에서는 해당 데이터와 연결 된 형식에 대 한 DataObject를 쿼리 합니다.The following code example queries a DataObject for the formats associated with its data. 첫 번째 쿼리는 false으로 autoConvert 매개 변수를 지정 하므로 데이터의 네이티브 형식만 반환 됩니다.The first query specifies the autoConvert parameter as false, so only the native format of the data is returned. 두 번째 쿼리는 true으로 autoConvert 매개 변수를 지정 하므로 형식 목록은 데이터를 변환할 수 있는 형식을 포함 합니다.The second query specifies the autoConvert parameter as true, so the list of formats includes the formats that the data can be converted to.

이 코드를 실행 하려면 textBox1 만들었습니다.This code requires that textBox1 has been created.

private:
   void GetAllFormats2()
   {
      // Creates a new data object using a string and the text format.
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,"Another string" );
      
      // Gets the original data formats in the DataObject.
      array<String^>^ arrayOfFormats = myDataObject->GetFormats( false );
      
      // Prints the results.
      textBox1->Text = "The format(s) associated with the data are: \n";
      for ( int i = 0; i < arrayOfFormats->Length; i++ )
      {
         textBox1->Text = String::Concat( textBox1->Text, arrayOfFormats[ i ], "\n" );
      }
      
      // Gets the all data formats and data conversion formats for the DataObject.
      arrayOfFormats = myDataObject->GetFormats( true );
      
      // Prints the results.
      textBox1->Text = String::Concat( textBox1->Text , "The data formats and conversion ",
         "format(s) associated with the data are: \n" );
      for ( int i = 0; i < arrayOfFormats->Length; i++ )
      {
         textBox1->Text = String::Concat( textBox1->Text, arrayOfFormats[ i ], "\n" );
      }
   }
private void GetAllFormats2() {
    // Creates a new data object using a string and the text format.
    DataObject myDataObject = new DataObject(DataFormats.Text, "Another string");
 
    // Gets the original data formats in the DataObject.
    String[] arrayOfFormats = myDataObject.GetFormats(false);
 
    // Prints the results.
    textBox1.Text = "The format(s) associated with the data are: " + '\n';
    for(int i=0; i<arrayOfFormats.Length; i++)
       textBox1.Text += arrayOfFormats[i] + '\n';
 
    // Gets the all data formats and data conversion formats for the DataObject.
    arrayOfFormats = myDataObject.GetFormats(true);
 
    // Prints the results.
    textBox1.Text += "The data formats and conversion format(s) associated with " +
       "the data are: " + '\n';
    for(int i=0; i<arrayOfFormats.Length; i++)
       textBox1.Text += arrayOfFormats[i] + '\n';
 }
 
Private Sub GetAllFormats2()
    ' Creates a new data object using a string and the text format.
    Dim myDataObject As New DataObject(DataFormats.Text, "Another string")
    
    ' Gets the original data formats in the DataObject.
    Dim arrayOfFormats As String() = myDataObject.GetFormats(False)
    
    ' Prints the results.
    textBox1.Text = "The format(s) associated with the data are: " & ControlChars.Cr
    Dim i As Integer
    For i = 0 To arrayOfFormats.Length - 1
        textBox1.Text += arrayOfFormats(i) + ControlChars.Cr
    Next i 
    ' Gets the all data formats and data conversion formats for the DataObject.
    arrayOfFormats = myDataObject.GetFormats(True)
    
    ' Prints the results.
    textBox1.Text += "The data formats and conversion format(s) associated with " & _
        "the data are: " & ControlChars.Cr
        
    For i = 0 To arrayOfFormats.Length - 1
        textBox1.Text += arrayOfFormats(i) + ControlChars.Cr
    Next i
End Sub

설명

GetData를 호출 하기 전에이 메서드를 호출 하 여 지원 되는 데이터 형식을 가져옵니다.Call this method to get the supported data formats before calling GetData. 미리 정의 된 형식에 대 한 DataFormats를 참조 하세요.See DataFormats 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.

추가 정보

적용 대상