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ğiyle öğesini Uri ve özelliğiyle Binding birlikte köprü metnini ayarlayan bir DataGridHyperlinkColumn gösterilmektedirContentBinding. olayıHyperlink.Click, öğesinin üst DataGridöğesi olduğ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 DataGridHyperlinkColumnörneği gösterilmektedir.

Not

Hyperlink gezinti yalnızca bir öğesinin doğrudan veya dolaylı üst öğesi Hyperlink bir gezinti konağıysa oluşabilir. Gezinti konaklarının örnekleri, , Frameveya XBAP'leri barındırabilen herhangi bir tarayıcıdı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 Uri özelliğini kullanarak Binding sütunu 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 değeri, 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).

Not

DataGridHyperlinkColumn düzenleme olmayan 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

DataGridHyperlinkColumn()

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

Alanlar

TargetNameProperty

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

Özellikler

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 başlığını sürükleyerek sütun görüntüleme konumunu değiştirip değiştiremeyeceğini belirten 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ı belirten 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	Sürükleme işlemi sırasında sütun başlığına 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 başlığının 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 başlığı işlenirken 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 belirten 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 minimum 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	Üyenin sıralama ölçütü olduğunu belirten 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

CancelCellEdit(FrameworkElement, Object)	Düzenlenen sütun hücresinin belirtilen değere geri dönmesine neden olur.
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 var olan bağımlılık özelliği için özellik meta verilerinde belirtilen herhangi bir CoerceValueCallback işlevi çağırarak DependencyObjectgerçekleştirilir. (Devralındığı yer: DependencyObject)
CommitCellEdit(FrameworkElement)	Düzenleme modundan çıkmadan önce gerekli doğrulamayı 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 Hyperlink okunur 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 ve belirtilen veri öğesini temsil eden satırın özellik değerini 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 özelleştirilmiş bir numaralandırıcı oluşturur. (Devralındığı yer: DependencyObject)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
GetValue(DependencyProperty)	Bir öğesinin bu örneğindeki bağımlılık özelliğinin DependencyObjectgeçerli geçerli 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)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
NotifyPropertyChanged(String)	Bu sütunu içeren öğesine DataGrid bir sütun özelliğinin değiştiğini bildirir. (Devralındığı yer: DataGridColumn)
OnBindingChanged(BindingBase, BindingBase)	Özelliğin DataGrid değeri değiştiğinde değerini Binding bildirir. (Devralındığı yer: DataGridBoundColumn)
OnCoerceIsReadOnly(Boolean)	Özelliğin IsReadOnly değerini, bu sütunu içeren veri kılavuzundaki özellik kurallarına göre 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)	Bu DependencyObject konudaki 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 özellik değeri değişikliğine yanıt olarak sütundaki bir hücrenin içeriğini yeniler.
SetCurrentValue(DependencyProperty, Object)	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 bağımlılık özelliğinin yerel değerini ayarlar. (Devralındığı yer: DependencyObject)
SetValue(DependencyPropertyKey, Object)	Salt okunur bağımlılık özelliğinin, bağımlılık özelliğinin DependencyPropertyKey tanımlayıcısı tarafından belirtilen 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 belirten bir değer döndürür. (Devralındığı yer: DependencyObject)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
VerifyAccess()	Çağıran iş parçacığının bu DispatcherObjectöğesine erişmesini zorlar. (Devralındığı yer: DispatcherObject)

Ekinlikler

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