Compartilhar via


IDataObject.GetFormats Método

Definição

Retorna uma lista de todos os formatos aos quais os dados armazenados nessa instância estão associados ou nos quais eles podem ser convertidos.

Sobrecargas

GetFormats()

Retorna uma lista de todos os formatos aos quais os dados armazenados nessa instância estão associados ou nos quais eles podem ser convertidos.

GetFormats(Boolean)

Obtém uma lista de todos os formatos aos quais os dados armazenados nesta instância estão associados ou nos quais eles podem ser convertidos, usando um valor booliano para determinar se deve-se recuperar todos os formatos nos quais os dados podem ser convertidos ou somente os formatos de dados nativos.

GetFormats()

Retorna uma lista de todos os formatos aos quais os dados armazenados nessa instância estão associados ou nos quais eles podem ser convertidos.

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

Retornos

String[]

Uma matriz de nomes que representa uma lista de todos os formatos com suporte nos dados armazenados nesse objeto.

Exemplos

Este exemplo usa a DataObject classe, que implementa IDataObject, para demonstrar o uso do GetFormats método. Primeiro, ele cria um objeto de dados (myDataObject) usando uma cadeia de caracteres e o Text formato. Em seguida, ele recupera todos os formatos de dados e formatos de conversão de dados no objeto de dados e exibe a lista resultante em uma caixa de mensagem. Este exemplo pressupõe que você tenha criado um Form nome 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

Comentários

Chame esse método para obter os formatos de dados com suporte antes de chamar o GetData método. Consulte a DataFormats classe para obter os formatos predefinidos.

Observação

Os dados poderão ser convertidos em outro formato se forem armazenados especificando se a conversão é permitida e se o formato solicitado for compatível com o formato armazenado. Por exemplo, os dados armazenados como Unicode podem ser convertidos em texto.

Para obter uma implementação desse método, consulte DataObject.GetFormats.

Confira também

Aplica-se a

GetFormats(Boolean)

Obtém uma lista de todos os formatos aos quais os dados armazenados nesta instância estão associados ou nos quais eles podem ser convertidos, usando um valor booliano para determinar se deve-se recuperar todos os formatos nos quais os dados podem ser convertidos ou somente os formatos de dados nativos.

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()

Parâmetros

autoConvert
Boolean

true para recuperar todos os formatos aos quais os dados armazenados nesta instância estão associados ou nos quais podem ser convertidos; false para recuperar somente os formatos de dados nativos.

Retornos

String[]

Uma matriz de nomes que representa uma lista de todos os formatos com suporte nos dados armazenados nesse objeto.

Exemplos

Este exemplo usa a DataObject classe, que implementa IDataObject, para demonstrar o uso do GetFormats método. Primeiro, ele cria um objeto de dados (myDataObject) usando uma cadeia de caracteres e o UnicodeText formato. Em seguida, ele faz duas consultas para obter os formatos associados aos dados. Na primeira consulta, ela define o autoConvert parâmetro como false : nesse caso, somente o formato nativo dos dados é retornado. Na segunda consulta, ela define o autoConvert parâmetro como , para trueque ele obtenha a lista de formatos, incluindo os formatos para os quais os dados podem ser convertidos. Em cada caso, a lista resultante é exibida em uma caixa de mensagem. Este exemplo pressupõe que você tenha criado um Form nome 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

Comentários

Chame esse método para obter os formatos de dados com suporte antes de chamar o GetData método. Consulte a DataFormats classe para obter os formatos predefinidos.

Observação

Os dados poderão ser convertidos em outro formato se forem armazenados especificando se a conversão é permitida e se o formato solicitado for compatível com o formato armazenado. Por exemplo, os dados armazenados como Unicode podem ser convertidos em texto.

Para obter uma implementação desse método, consulte DataObject.GetFormats.

Confira também

Aplica-se a