IDataObject.GetFormats Método

Definición

Devuelve una lista de todos los formatos a los que se asocian o a los que pueden convertirse los datos almacenados en esta instancia.Returns a list of all formats that data stored in this instance is associated with or can be converted to.

Sobrecargas

GetFormats()

Devuelve una lista de todos los formatos a los que se asocian o a los que pueden convertirse los datos almacenados en esta instancia.Returns a list of all formats that data stored in this instance is associated with or can be converted to.

GetFormats(Boolean)

Obtiene una lista con todos los formatos a los que están asociados o se pueden convertir los datos almacenados en esta instancia, usando un valor de tipo booleano para determinar si se recuperarán sólo los formatos de datos nativos o todos los formatos a los que pueden convertirse los datos.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()

Devuelve una lista de todos los formatos a los que se asocian o a los que pueden convertirse los datos almacenados en esta instancia.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()

Devoluciones

String[]

Matriz de nombres que representa una lista de todos los formatos admitidos por los datos almacenados en este objeto.An array of the names that represents a list of all formats that are supported by the data stored in this object.

Ejemplos

En este ejemplo se DataObject usa la clase, que IDataObjectimplementa, para GetFormats mostrar el uso del método.This example uses the DataObject class, which implements IDataObject, to demonstrate the use of the GetFormats method. En primer lugar, crea un objeto demyDataObjectdatos () mediante una cadena Text y el formato.First, it creates a data object (myDataObject) using a string and the Text format. A continuación, se recuperan todos los formatos de datos y los formatos de conversión de datos del objeto de datos y se muestra la lista resultante en un cuadro de mensaje.Then it retrieves all the data formats and data conversion formats in the data object, and displays the resulting list in a message box. En este ejemplo se da por supuesto que Form ha Form1creado un denominado.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

Comentarios

Llame a este método para obtener los formatos de datos admitidos GetData antes de llamar al método.Call this method to get the supported data formats before calling the GetData method. Vea la DataFormats clase para obtener los formatos predefinidos.See the DataFormats class for the predefined formats.

Nota

Los datos se pueden convertir a otro formato si se almacenaron especificando que se permite la conversión y si el formato solicitado es compatible con el formato almacenado.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. Por ejemplo, los datos almacenados como Unicode se pueden convertir en texto.For example, data stored as Unicode can be converted to text.

Para obtener una implementación de este método, DataObject.GetFormatsvea.For an implementation of this method, see DataObject.GetFormats.

Consulte también:

GetFormats(Boolean)

Obtiene una lista con todos los formatos a los que están asociados o se pueden convertir los datos almacenados en esta instancia, usando un valor de tipo booleano para determinar si se recuperarán sólo los formatos de datos nativos o todos los formatos a los que pueden convertirse los datos.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()

Parámetros

autoConvert
Boolean

true para recuperar todos los formatos a los que están asociados o a los que pueden convertirse los datos almacenados en esta instancia; false para recuperar sólo los formatos de datos nativos.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.

Devoluciones

String[]

Matriz de nombres que representa una lista de todos los formatos admitidos por los datos almacenados en este objeto.An array of the names that represents a list of all formats that are supported by the data stored in this object.

Ejemplos

En este ejemplo se DataObject usa la clase, que IDataObjectimplementa, para GetFormats mostrar el uso del método.This example uses the DataObject class, which implements IDataObject, to demonstrate the use of the GetFormats method. En primer lugar, crea un objeto demyDataObjectdatos () mediante una cadena UnicodeText y el formato.First, it creates a data object (myDataObject) using a string and the UnicodeText format. A continuación, realiza dos consultas para obtener los formatos asociados a los datos.Then it makes two queries to get the formats associated with the data. En la primera consulta, establece el autoConvert false parámetro en: en este caso, solo se devuelve el formato nativo de los datos.In the first query, it sets the autoConvert parameter to false : in this case, only the native format of the data is returned. En la segunda consulta, establece el autoConvert parámetro en true, de modo que obtiene la lista de formatos, incluidos los formatos a los que se pueden convertir los datos.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. En cada caso, la lista resultante se muestra en un cuadro de mensaje.In each case, the resulting list is displayed in a message box. En este ejemplo se da por supuesto que Form ha Form1creado un denominado.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

Comentarios

Llame a este método para obtener los formatos de datos admitidos GetData antes de llamar al método.Call this method to get the supported data formats before calling the GetData method. Vea la DataFormats clase para obtener los formatos predefinidos.See the DataFormats class for the predefined formats.

Nota

Los datos se pueden convertir a otro formato si se almacenaron especificando que se permite la conversión y si el formato solicitado es compatible con el formato almacenado.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. Por ejemplo, los datos almacenados como Unicode se pueden convertir en texto.For example, data stored as Unicode can be converted to text.

Para obtener una implementación de este método, DataObject.GetFormatsvea.For an implementation of this method, see DataObject.GetFormats.

Consulte también:

Se aplica a