DataGridHyperlinkColumn Sınıf

Tanım

Ad Alanı:

System.Windows.Controls

Bütünleştirilmiş Kod:

PresentationFramework.dll

Hücrelerinde öğeleri barındıran Uri bir DataGrid sütunu temsil eder.

public ref class DataGridHyperlinkColumn : System::Windows::Controls::DataGridBoundColumn

public class DataGridHyperlinkColumn : System.Windows.Controls.DataGridBoundColumn

type DataGridHyperlinkColumn = class
    inherit DataGridBoundColumn

Public Class DataGridHyperlinkColumn
Inherits DataGridBoundColumn

Devralma

Object

DispatcherObject

DependencyObject

DataGridColumn

DataGridBoundColumn

DataGridHyperlinkColumn

Örnekler

Aşağıdaki örnekte, özelliğini ve köprü metnini özelliğiyle Binding ayarlayan Uri bir DataGridHyperlinkColumn gösterilmektedirContentBinding. olayıHyperlink.Click, öğesinin üst öğesi DataGridolduğundan NavigationWindow otomatik olarak işlenir.

<NavigationWindow x:Class="DataGrid_CustomColumns.Window1"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:core="clr-namespace:System;assembly=mscorlib"
    xmlns:local="clr-namespace:DataGrid_CustomColumns"
    Title="Customers" Height="300" Width="300" ShowsNavigationUI="False"  >
    
<NavigationWindow.Resources>

    <!--Create an instance of the converter for Email-->
    <local:EmailConverter x:Key="EmailConverter" />
</NavigationWindow.Resources>
<NavigationWindow.Content>  
    
<Grid>
    <DataGrid Name="DG1" ItemsSource="{Binding}" AutoGenerateColumns="False" >
        <DataGrid.Columns>

<!--The Email property contains a URI.  For example "mailto:lucy0@adventure-works.com"-->
<DataGridHyperlinkColumn Header="Email" Binding="{Binding Email}"  ContentBinding="{Binding Email, Converter={StaticResource EmailConverter}}" />

            </DataGrid.Columns>
        </DataGrid>
    </Grid>
    </NavigationWindow.Content>
</NavigationWindow>

public partial class Window1 : NavigationWindow
{

Class Window1

public Window1()
{
    InitializeComponent();

    //GetData() creates a collection of Customer data from a database
    ObservableCollection<Customer> custdata = GetData();
    
    //Bind the DataGrid to the customer data
    DG1.DataContext = custdata;
}

Public Sub New()
    ' This call is required by the Windows Form Designer.
    InitializeComponent()
    ' Add any initialization after the InitializeComponent() call.

    'GetData() creates a collection of Customer data from a database
    Dim custdata As ObservableCollection(Of Customer) = GetData()

    'Bind the DataGrid to the customer data
    DG1.DataContext = custdata

End Sub

//Defines the customer object
public class Customer
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public Uri Email { get; set; }
    public bool IsMember { get; set; }
    public OrderStatus Status { get; set; }
}

'Defines the customer object
Public Class Customer
    Public Property FirstName() As String
    Public Property LastName() As String
    Public Property Email() As Uri
    Public Property IsMember() As Boolean
    Public Property Status() As OrderStatus
End Class

}

End Class

//Converts the mailto uri to a string with just the customer alias
public class EmailConverter : IValueConverter
{
    public object Convert(object value, Type targetType, object parameter, System.Globalization.CultureInfo culture)
    {
        if (value != null)
        {
            string email = value.ToString();
            int index = email.IndexOf("@");
            string alias = email.Substring(7, index-7);
            return alias;
        }
        else
        {
            string email = "";
            return email;
        }
    }

    public object ConvertBack(object value, Type targetType, object parameter, System.Globalization.CultureInfo culture)
    {
        Uri email = new Uri((string)value);
        return email;
    }
}

'Converts the mailto uri to a string with just the customer alias
Public Class EmailConverter
    Implements IValueConverter

    Public Function Convert(value As Object, targetType As System.Type, parameter As Object, culture As System.Globalization.CultureInfo) As Object Implements System.Windows.Data.IValueConverter.Convert
        If value IsNot Nothing Then
            Dim email As String = value.ToString()
            Dim index As Integer = email.IndexOf("@")
            Dim [alias] As String = email.Substring(7, index - 7)
            Return [alias]
        Else
            Dim email As String = ""
            Return email
        End If
    End Function

    Public Function ConvertBack(value As Object, targetType As System.Type, parameter As Object, culture As System.Globalization.CultureInfo) As Object Implements System.Windows.Data.IValueConverter.ConvertBack
        Dim email As New Uri(DirectCast(value, String))
        Return email
    End Function
End Class

Açıklamalar

HTTP adresi veya e-posta adresi gibi bir Uriiçeren verileri görüntülemek için kullanınDataGridHyperlinkColumn. Aşağıdaki çizimde bir örneği gösterilmektedir DataGridHyperlinkColumn.

Uyarı

Hyperlink gezinti yalnızca bir Hyperlink öğesinin doğrudan veya dolaylı üst öğesi bir gezinti konağıysa oluşabilir. Gezinti konaklarının örnekleri arasında , Frameveya XBAP'leri barındırabilen herhangi bir tarayıcı yer alırNavigationWindow. Daha fazla bilgi için Gezintiye Genel Bakış'taki "Gezinti Konakları" makalesine bakın.

XBAP desteği hakkında daha fazla bilgi için bkz. WPF tarayıcı tarafından barındırılan uygulamalar (XBAP) hakkında sık sorulan sorular.

Sütunu doldurmak için özelliğini kullanarak Binding sütunu Uri verilere bağlayın. URI dizesinden farklı bir köprü metni görüntülemek için, metin değerini özelliğine ContentBinding bağlayın. Binding özelliği, sütunda oluşturulan veya TextBox öğesine uygulanırHyperlink. DataContext Her hücredeki öğesinin öğesi, hücrenin içinde olduğu satırın veri öğesidir. Bu nedenle, bağlamayı ayarlamak için yalnızca öğesini ayarlamanız Binding.Pathgerekir. İsteğe bağlı olarak, verileri dönüştürmek istiyorsanız bir Binding.Converter belirtebilirsiniz. Veri bağlama hakkında daha fazla bilgi için bkz. Veri Bağlama (WPF).

Uyarı

DataGridHyperlinkColumn düzenleme dışı modda bir Hyperlink öğe ve düzenleme modunda bir TextBox öğe oluşturur.

Diğer veri türlerini görüntülemek istiyorsanız, DataGrid aşağıdaki sütun türlerini sağlar:

Sütun Türü	Veri Görüntüleme
DataGridCheckBoxColumn	Boole verilerini görüntülemek için kullanın.
DataGridComboBoxColumn	Numaralandırma verilerini görüntülemek için kullanın.
DataGridTextColumn	Metin görüntülemek için kullanın.

içinde DataGridbaşka denetimler kullanmak istiyorsanız kullanarak DataGridTemplateColumnkendi sütun türlerinizi oluşturabilirsiniz.

Oluşturucular

Name	Description
DataGridHyperlinkColumn()	DataGridHyperlinkColumn sınıfının yeni bir örneğini başlatır.

Alanlar

Name	Description
TargetNameProperty	TargetName Bağımlılık özelliğini tanımlar.

Özellikler

Name	Description
ActualWidth	Cihazdan bağımsız birimlerde (birim başına 1/96 inç) sütunun geçerli genişliğini alır. (Devralındığı yer: DataGridColumn)
Binding	Sütunu veri kaynağındaki bir özellik ile ilişkilendiren bağlamayı alır veya ayarlar. (Devralındığı yer: DataGridBoundColumn)
CanUserReorder	Kullanıcının sütun üst bilgisini sürükleyerek sütun görüntüleme konumunu değiştirip değiştiremeyeceğini gösteren bir değer alır veya ayarlar. (Devralındığı yer: DataGridColumn)
CanUserResize	Kullanıcının fareyi kullanarak sütun genişliğini ayarlayıp ayarlayamayacağını gösteren bir değer alır veya ayarlar. (Devralındığı yer: DataGridColumn)
CanUserSort	Kullanıcının sütun üst bilgisine tıklayarak sütunu sıralayıp sıralayamayacağını belirten bir değer alır veya ayarlar. (Devralındığı yer: DataGridColumn)
CellStyle	Sütundaki hücreleri işlemek için kullanılan stili alır veya ayarlar. (Devralındığı yer: DataGridColumn)
ClipboardContentBinding	Pano için hücre içeriğini alırken veya ayarlarken kullanılacak bağlama nesnesini alır veya ayarlar. (Devralındığı yer: DataGridBoundColumn)
ContentBinding	Bağlamayı köprü metnine alır veya ayarlar.
DataGridOwner	DataGrid Bu sütunu içeren denetimi alır. (Devralındığı yer: DataGridColumn)
DefaultEditingElementStyle	Özelliğinin EditingElementStyle varsayılan değeri.
DefaultElementStyle	Özelliğinin ElementStyle varsayılan değeri.
DependencyObjectType	DependencyObjectType Bu örneğin CLR türünü sarmalayan öğesini alır. (Devralındığı yer: DependencyObject)
Dispatcher	Dispatcher Bunun DispatcherObject ilişkili olduğu öğesini alır. (Devralındığı yer: DispatcherObject)
DisplayIndex	sütunun görüntüleme konumunu içindeki diğer sütunlara DataGridgöre alır veya ayarlar. (Devralındığı yer: DataGridColumn)
DragIndicatorStyle	Bir sürükleme işlemi sırasında sütun üst bilgisine uygulanacak stil nesnesini alır veya ayarlar. (Devralındığı yer: DataGridColumn)
EditingElementStyle	Düzenleme modunda bir hücre için sütunun görüntülediği öğe işlenirken kullanılan stili alır veya ayarlar. (Devralındığı yer: DataGridBoundColumn)
ElementStyle	Düzenleme modunda olmayan bir hücre için sütunun görüntülediği öğe işlenirken kullanılan stili alır veya ayarlar. (Devralındığı yer: DataGridBoundColumn)
Header	Sütun üst bilgisinin içeriğini alır veya ayarlar. (Devralındığı yer: DataGridColumn)
HeaderStringFormat	Sütun üst bilgisinin içeriğine uygulanacak biçim desenini alır veya ayarlar. (Devralındığı yer: DataGridColumn)
HeaderStyle	Sütun üst bilgisini işlerken kullanılan stili alır veya ayarlar. (Devralındığı yer: DataGridColumn)
HeaderTemplate	Sütun başlığının görsel gösterimini tanımlayan şablonu alır veya ayarlar. (Devralındığı yer: DataGridColumn)
HeaderTemplateSelector	Sütun başlığı için hangi şablonun kullanılacağını seçen nesneyi alır veya ayarlar. (Devralındığı yer: DataGridColumn)
IsAutoGenerated	Sütunun otomatik olarak oluşturulup oluşturulmadığını gösteren bir değer alır. (Devralındığı yer: DataGridColumn)
IsFrozen	Sütunun yatay olarak kaydırılmasının engellenip engellenmediğini gösteren bir değer alır. (Devralındığı yer: DataGridColumn)
IsReadOnly	Sütundaki hücrelerin düzenlenip düzenlenemeyeceğini gösteren bir değer alır veya ayarlar. (Devralındığı yer: DataGridColumn)
IsSealed	Bu örneğin şu anda korumalı (salt okunur) olup olmadığını gösteren bir değer alır. (Devralındığı yer: DependencyObject)
MaxWidth	Sütunun en büyük genişlik kısıtlamasını alır veya ayarlar. (Devralındığı yer: DataGridColumn)
MinWidth	Sütunun en düşük genişlik kısıtlamasını alır veya ayarlar. (Devralındığı yer: DataGridColumn)
SortDirection	Sütunun sıralama yönünü (artan veya azalan) alır veya ayarlar. (Devralındığı yer: DataGridColumn)
SortMemberPath	Sıralama ölçütü olarak üyeyi gösteren bir özellik adı veya noktayla ayrılmış özellik adları hiyerarşisini alır veya ayarlar. (Devralındığı yer: DataGridColumn)
TargetName	Köprü için hedef pencerenin veya çerçevenin adını alır veya ayarlar.
Visibility	Sütunun görünürlüğünü alır veya ayarlar. (Devralındığı yer: DataGridColumn)
Width	Sütun genişliğini veya otomatik boyutlandırma modunu alır veya ayarlar. (Devralındığı yer: DataGridColumn)

Yöntemler

Name	Description
CancelCellEdit(FrameworkElement, Object)	Düzenlenen sütun hücresinin belirtilen değere geri döndürülmesini sağlar.
CheckAccess()	Çağıran iş parçacığının bu DispatcherObjectöğesine erişimi olup olmadığını belirler. (Devralındığı yer: DispatcherObject)
ClearValue(DependencyProperty)	Bir özelliğin yerel değerini temizler. Temizlenecek özellik bir DependencyProperty tanımlayıcı tarafından belirtilir. (Devralındığı yer: DependencyObject)
ClearValue(DependencyPropertyKey)	Salt okunur özelliğin yerel değerini temizler. Temizlenecek özellik tarafından DependencyPropertyKeybelirtilir. (Devralındığı yer: DependencyObject)
CoerceValue(DependencyProperty)	Belirtilen bağımlılık özelliğinin değerini zorlama. Bu, çağrısında CoerceValueCallbackvar olan bağımlılık özelliği için özellik meta verilerinde belirtilen herhangi bir DependencyObject işlevi çağırarak gerçekleştirilir. (Devralındığı yer: DependencyObject)
CommitCellEdit(FrameworkElement)	Düzenleme modundan çıkmadan önce gerekli doğrulamaları gerçekleştirir.
Equals(Object)	Sağlanan DependencyObject öğesinin geçerli DependencyObjectile eşdeğer olup olmadığını belirler. (Devralındığı yer: DependencyObject)
GenerateEditingElement(DataGridCell, Object)	Sütunun ContentBinding özellik değerine bağlı düzenlenebilir TextBox bir öğe alır.
GenerateElement(DataGridCell, Object)	Sütunun ContentBinding özellik değerine bağlı salt okunur Hyperlink bir öğe alır.
GetCellContent(DataGridRow)	Bu sütunun Content ve belirtilen satırın kesişiminde hücrenin özellik değerini alır. (Devralındığı yer: DataGridColumn)
GetCellContent(Object)	Bu sütunun Content kesişim noktasındaki hücrenin özellik değerini ve belirtilen veri öğesini temsil eden satırı alır. (Devralındığı yer: DataGridColumn)
GetHashCode()	Bu DependencyObjectiçin bir karma kodu alır. (Devralındığı yer: DependencyObject)
GetLocalValueEnumerator()	Hangi bağımlılık özelliklerinin bu DependencyObjectüzerinde yerel olarak ayarlı değerlere sahip olduğunu belirlemek için özel bir numaralandırıcı oluşturur. (Devralındığı yer: DependencyObject)
GetValue(DependencyProperty)	Bir öğesinin bu örneğindeki bir bağımlılık özelliğinin DependencyObjectgeçerli etkin değerini döndürür. (Devralındığı yer: DependencyObject)
InvalidateProperty(DependencyProperty)	Belirtilen bağımlılık özelliği için geçerli değeri yeniden değerlendirir. (Devralındığı yer: DependencyObject)
NotifyPropertyChanged(String)	DataGrid Bu sütunu içeren öğesine bir sütun özelliğinin değiştiğini bildirir. (Devralındığı yer: DataGridColumn)
OnBindingChanged(BindingBase, BindingBase)	Özelliğin DataGrid değerinin Binding ne zaman değiştiğini bildirir. (Devralındığı yer: DataGridBoundColumn)
OnCoerceIsReadOnly(Boolean)	Bu sütunu içeren veri kılavuzundan özellik kurallarına göre özelliğin değerini IsReadOnly belirler. (Devralındığı yer: DataGridBoundColumn)
OnContentBindingChanged(BindingBase, BindingBase)	Özelliğin DataGrid ne zaman ContentBinding değiştiğini bildirir.
OnCopyingCellClipboardContent(Object)	Olayı tetikler CopyingCellClipboardContent . (Devralındığı yer: DataGridColumn)
OnPastingCellClipboardContent(Object, Object)	Olayı tetikler PastingCellClipboardContent . (Devralındığı yer: DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Bunun DependencyObject üzerindeki herhangi bir bağımlılık özelliğinin etkin değeri her güncelleştirildiğinde çağrılır. Değiştirilen belirli bağımlılık özelliği olay verilerinde bildirilir. (Devralındığı yer: DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)	Sütundaki bir hücre düzenleme moduna girdiğinde çağrılır.
ReadLocalValue(DependencyProperty)	Varsa, bağımlılık özelliğinin yerel değerini döndürür. (Devralındığı yer: DependencyObject)
RefreshCellContent(FrameworkElement, String)	Sütun özelliği değer değişikliğine yanıt olarak sütundaki bir hücrenin içeriğini yeniler.
SetCurrentValue(DependencyProperty, Object)	Bir bağımlılık özelliğinin değerini, değer kaynağını değiştirmeden ayarlar. (Devralındığı yer: DependencyObject)
SetValue(DependencyProperty, Object)	Bağımlılık özelliği tanımlayıcısı tarafından belirtilen bir bağımlılık özelliğinin yerel değerini ayarlar. (Devralındığı yer: DependencyObject)
SetValue(DependencyPropertyKey, Object)	Bağımlılık özelliğinin tanımlayıcısı tarafından belirtilen salt okunur bağımlılık özelliğinin DependencyPropertyKey yerel değerini ayarlar. (Devralındığı yer: DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Serileştirme işlemlerinin sağlanan bağımlılık özelliği için değeri serileştirmesi gerekip gerekmediğini gösteren bir değer döndürür. (Devralındığı yer: DependencyObject)
VerifyAccess()	Çağıran iş parçacığının bu DispatcherObjectöğesine erişmesini zorlar. (Devralındığı yer: DispatcherObject)

Ekinlikler

Name	Description
CopyingCellClipboardContent	Hücre panosu içeriği hazırlandıktan sonra gerçekleşir. (Devralındığı yer: DataGridColumn)
PastingCellClipboardContent	Pano içeriği hücreye taşınmadan önce gerçekleşir. (Devralındığı yer: DataGridColumn)

Ayrıca bkz.

• Hyperlink