DataObject.GetData Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Verileri belirtilen veri biçiminde döndürür.
Aşırı Yüklemeler
GetData(String) |
Verileri bir dize tarafından belirtilen biçimde döndürür. |
GetData(Type) |
Bir nesne tarafından belirtilen biçimde bir Type veri nesnesi döndürür. |
GetData(String, Boolean) |
Bir veri nesnesini belirtilen biçimde döndürür ve isteğe bağlı olarak verileri belirtilen biçime dönüştürür. |
GetData(String)
Verileri bir dize tarafından belirtilen biçimde döndürür.
public:
virtual System::Object ^ GetData(System::String ^ format);
public object GetData (string format);
abstract member GetData : string -> obj
override this.GetData : string -> obj
Public Function GetData (format As String) As Object
Parametreler
- format
- String
Verilerin biçimini belirten bir dize. Önceden tanımlanmış veri biçimleri kümesi için sınıfına DataFormats bakın.
Döndürülenler
Belirtilen biçimdeki verileri içeren veya null
veriler belirtilen biçimde kullanılamıyorsa bir nesne.
Uygulamalar
Özel durumlar
format
, null
değeridir.
Örnekler
Aşağıdaki örnek, önce belirtilen veri biçiminin kullanılabilir olup olmadığını denetlemek için bu yöntemi kullanır (yerel olarak veya otomatik dönüştürme yoluyla); belirtilen biçim varsa, örnek yöntemini kullanarak GetData(String) verileri alır.
DataObject dataObject = new DataObject("Some string data to store...");
string desiredFormat = DataFormats.UnicodeText;
byte[] data = null;
// Use the GetDataPresent method to check for the presence of a desired data format.
// This particular overload of GetDataPresent looks for both native and auto-convertible
// data formats.
if (dataObject.GetDataPresent(desiredFormat))
{
// If the desired data format is present, use one of the GetData methods to retrieve the
// data from the data object.
data = dataObject.GetData(desiredFormat) as byte[];
}
Dim dataObject As New DataObject("Some string data to store...")
Dim desiredFormat As String = DataFormats.UnicodeText
Dim data() As Byte = Nothing
' Use the GetDataPresent method to check for the presence of a desired data format.
' This particular overload of GetDataPresent looks for both native and auto-convertible
' data formats.
If dataObject.GetDataPresent(desiredFormat) Then
' If the desired data format is present, use one of the GetData methods to retrieve the
' data from the data object.
data = TryCast(dataObject.GetData(desiredFormat), Byte())
End If
Aşağıdaki örnek kod, önce belirtilen veri biçiminin GetDataPresent(String, Boolean) yerel olarak kullanılabilir olup olmadığını denetlemek için yöntemini kullanır (otomatik dönüştürülebilir veri biçimleri filtrelenir); belirtilen biçim varsa, örnek yöntemini kullanarak GetData(String) verileri alır.
DataObject dataObject = new DataObject("Some string data to store...");
string desiredFormat = DataFormats.UnicodeText;
bool noAutoConvert = false;
byte[] data = null;
// Use the GetDataPresent method to check for the presence of a desired data format.
// The autoconvert parameter is set to false to filter out auto-convertible data formats,
// returning true only if the specified data format is available natively.
if (dataObject.GetDataPresent(desiredFormat, noAutoConvert))
{
// If the desired data format is present, use one of the GetData methods to retrieve the
// data from the data object.
data = dataObject.GetData(desiredFormat) as byte[];
}
Dim dataObject As New DataObject("Some string data to store...")
Dim desiredFormat As String = DataFormats.UnicodeText
Dim noAutoConvert As Boolean = False
Dim data() As Byte = Nothing
' Use the GetDataPresent method to check for the presence of a desired data format.
' The autoconvert parameter is set to false to filter out auto-convertible data formats,
' returning true only if the specified data format is available natively.
If dataObject.GetDataPresent(desiredFormat, noAutoConvert) Then
' If the desired data format is present, use one of the GetData methods to retrieve the
' data from the data object.
data = TryCast(dataObject.GetData(desiredFormat), Byte())
End If
Ayrıca bkz.
Şunlara uygulanır
GetData(Type)
Bir nesne tarafından belirtilen biçimde bir Type veri nesnesi döndürür.
public:
virtual System::Object ^ GetData(Type ^ format);
public object GetData (Type format);
abstract member GetData : Type -> obj
override this.GetData : Type -> obj
Public Function GetData (format As Type) As Object
Parametreler
- format
- Type
Type Verilerin biçimini belirten bir. Önceden tanımlanmış veri biçimleri kümesi için sınıfına DataFormats bakın.
Döndürülenler
Verilerin belirtilen biçimde olduğu veya null
verilerin belirtilen biçimde kullanılamadığı bir veri nesnesi.
Uygulamalar
Özel durumlar
format
, null
değeridir.
Ayrıca bkz.
Şunlara uygulanır
GetData(String, Boolean)
Bir veri nesnesini belirtilen biçimde döndürür ve isteğe bağlı olarak verileri belirtilen biçime dönüştürür.
public:
virtual System::Object ^ GetData(System::String ^ format, bool autoConvert);
public object GetData (string format, bool autoConvert);
abstract member GetData : string * bool -> obj
override this.GetData : string * bool -> obj
Public Function GetData (format As String, autoConvert As Boolean) As Object
Parametreler
- format
- String
Verilerin biçimini belirten bir dize. Önceden tanımlanmış veri biçimleri kümesi için sınıfına DataFormats bakın.
- autoConvert
- Boolean
true
verileri otomatik olarak belirtilen biçime dönüştürmeyi dener; false
veri biçimi dönüştürme için.
Döndürülenler
Verilerin belirtilen biçimde olduğu veya null
verilerin belirtilen biçimde kullanılamadığı bir veri nesnesi.
autoConvert
Parametre ise true
ve veriler belirtilen biçime dönüştürülemiyorsa veya otomatik dönüştürme devre dışıysa (parametresi olarak ayarlanarak çağrılarak false
SetData(String, Object, Boolean) autoConvert
), bu yöntem döndürürnull
.
Uygulamalar
Özel durumlar
format
null değeridir.