Compartir vía


DataObject.GetFormats Método

Definición

Devuelve una lista de todos los formatos a los que se asocian o a los que se pueden convertir los datos almacenados en este objeto DataObject.

Sobrecargas

GetFormats()

Devuelve una lista de todos los formatos a los que se asocian o a los que se pueden convertir los datos almacenados en este objeto DataObject.

GetFormats(Boolean)

Devuelve una lista con todos los formatos a los que están asociados o se pueden convertir los datos almacenados en este objeto DataObject, utilizando un parámetro de conversión automática para determinar si se van a recuperar sólo los formatos de datos nativos o todos los formatos a los que se puedan convertir los datos.

GetFormats()

Devuelve una lista de todos los formatos a los que se asocian o a los que se pueden convertir los datos almacenados en este objeto DataObject.

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

Devoluciones

String[]

Una matriz de tipo String, que contiene una lista de todos los formatos admitidos por los datos almacenados en este objeto.

Implementaciones

Ejemplos

En el ejemplo de código siguiente se consulta un DataObject para los formatos asociados a sus datos y los formatos a los que se pueden convertir los datos. La lista resultante se muestra en un cuadro de texto. Este código requiere que textBox1 se haya creado.

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

Comentarios

Llame a este método para obtener los formatos de datos admitidos antes de llamar a GetData. Consulte DataFormats para conocer los formatos predefinidos.

Nota

Los datos se pueden convertir a otro formato si se almacenó especificando que se permite la conversión y si el formato solicitado es compatible con el formato almacenado. Por ejemplo, los datos almacenados como Unicode se pueden convertir en texto.

Consulte también

Se aplica a

GetFormats(Boolean)

Devuelve una lista con todos los formatos a los que están asociados o se pueden convertir los datos almacenados en este objeto DataObject, utilizando un parámetro de conversión automática para determinar si se van a recuperar sólo los formatos de datos nativos o todos los formatos a los que se puedan convertir los datos.

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 los formatos a los que están asociados o se pueden convertir los datos almacenados en este objeto DataObject; false para recuperar sólo los formatos de datos nativos.

Devoluciones

String[]

Una matriz de tipo String, que contiene una lista de todos los formatos admitidos por los datos almacenados en este objeto.

Implementaciones

Ejemplos

En el ejemplo de código siguiente se consulta un DataObject para los formatos asociados a sus datos. La primera consulta especifica el autoConvert parámetro como false, por lo que solo se devuelve el formato nativo de los datos. La segunda consulta especifica el autoConvert parámetro como true, por lo que la lista de formatos incluye los formatos a los que se pueden convertir los datos.

Este código requiere que textBox1 se haya creado.

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

Comentarios

Llame a este método para obtener los formatos de datos admitidos antes de llamar a GetData. Consulte DataFormats para conocer los formatos predefinidos.

Nota

Los datos se pueden convertir a otro formato si se almacenó especificando que se permite la conversión y si el formato solicitado es compatible con el formato almacenado. Por ejemplo, los datos almacenados como Unicode se pueden convertir en texto.

Consulte también

Se aplica a