DataGridHyperlinkColumn Sınıf

Tanım

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

Ö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.

DataGridHyperlinkColumn ve e-posta adresleri

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.

CancelCellEdit(FrameworkElement, Object)

Düzenlenen hücrenin özgün, düzenlenmemiş değere geri dönmesine neden olur.

(Devralındığı yer: DataGridColumn)
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.

CommitCellEdit(FrameworkElement)

Hücre düzenleme modundan çıkmadan önce gerekli doğrulamayı gerçekleştirir.

(Devralındığı yer: DataGridColumn)
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)

Şunlara uygulanır

Ayrıca bkz.