IDataObject.GetFormats (Método) (Boolean)
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)
String[] GetFormats ( boolean autoConvert )
function GetFormats ( autoConvert : boolean ) : String[]
No aplicable.
Parámetros
- autoConvert
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.
Valor devuelto
Matriz de nombres que representa una lista de todos los formatos admitidos por los datos almacenados en este objeto.Se llama a este método antes de llamar al método GetData para obtener los formatos de datos admitidos. Para obtener los formatos predefinidos, vea la clase DataFormats.
 Nota: |
|---|
| Los datos se pueden convertir a otro formato si se han almacenado 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 a texto. |
Para obtener una implementación de este método, vea DataObject.GetFormats.
En este ejemplo se utiliza la clase DataObject, que implementa IDataObject, para mostrar cómo se utiliza el método GetFormats. En primer lugar, se crea un objeto de datos (myDataObject) utilizando una cadena y el formato UnicodeText. Después, se realizan dos consultas para obtener los formatos asociados a los datos. En la primera consulta, el parámetro autoConvert se establece en false; en este caso, sólo se devuelve el formato nativo de los datos. En la segunda consulta, el parámetro autoConvert se establece en true, de modo que se obtiene la lista de formatos, entre los que se incluyen los formatos a los que pueden convertirse los datos. En cada caso, la lista resultante se muestra en un cuadro de mensaje. En este ejemplo se supone que se ha creado un Form denominado Form1.
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 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);
} //GetFormats2
Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter
Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.