DataObject.GetFormats Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Retorna uma lista de todos os formatos aos quais os dados armazenados neste DataObject estão associados ou nos quais eles podem ser convertidos.

Sobrecargas

GetFormats()	Retorna uma lista de todos os formatos aos quais os dados armazenados neste DataObject estão associados ou nos quais eles podem ser convertidos.
GetFormats(Boolean)	Retorna uma lista de todos os formatos aos quais os dados armazenados neste DataObject estão associados ou nos quais eles podem ser convertidos, usando um parâmetro de conversão automática para determinar se é necessário recuperar somente os formatos de dados nativos ou todos os formatos nos quais os dados podem ser convertidos.

GetFormats()

Retorna uma lista de todos os formatos aos quais os dados armazenados neste DataObject estão associados ou nos quais eles podem ser convertidos.

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

Retornos

String[]

Uma matriz do tipo String, que contém uma lista de todos os formatos com suporte nos dados armazenados nesse objeto.

Implementações

GetFormats()

Exemplos

O exemplo de código a seguir consulta um DataObject para os formatos associados aos seus dados e os formatos para os quais os dados podem ser convertidos. A lista resultante é exibida em uma caixa de texto. Esse código requer que textBox1 tenha sido criado.

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

Comentários

Chame esse método para obter os formatos de dados com suporte antes de chamar GetData. Consulte DataFormats 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, dados armazenados como Unicode podem ser convertidos em texto.

Confira também

• GetData(String, Boolean)
• SetData(String, Boolean, Object)
• DataFormats
• GetDataPresent(Type)

GetFormats(Boolean)

Retorna uma lista de todos os formatos aos quais os dados armazenados neste DataObject estão associados ou nos quais eles podem ser convertidos, usando um parâmetro de conversão automática para determinar se é necessário recuperar somente os formatos de dados nativos ou todos os formatos nos quais os dados podem ser convertidos.

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

Parâmetros

autoConvert

Boolean

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

Retornos

String[]

Uma matriz do tipo String, que contém uma lista de todos os formatos com suporte nos dados armazenados nesse objeto.

Implementações

GetFormats(Boolean)

Exemplos

O exemplo de código a seguir consulta um DataObject para os formatos associados aos seus dados. A primeira consulta especifica o autoConvert parâmetro como false, portanto, somente o formato nativo dos dados é retornado. A segunda consulta especifica o autoConvert parâmetro como true, portanto, a lista de formatos inclui os formatos aos quais os dados podem ser convertidos.

Esse código requer que textBox1 tenha sido criado.

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

Comentários

Chame esse método para obter os formatos de dados com suporte antes de chamar GetData. Consulte DataFormats 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, dados armazenados como Unicode podem ser convertidos em texto.

Confira também

• GetData(String, Boolean)
• SetData(String, Boolean, Object)
• DataFormats
• GetDataPresent(Type)