DataGridHyperlinkColumn Klasa

Definicja

Przedstawia DataGrid kolumnę, która hostuje Uri elementy w jej komórkach.Represents a DataGrid column that hosts Uri elements in its cells.

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
Dziedziczenie

Przykłady

Poniższy przykład pokazuje DataGridHyperlinkColumn , że ustawia Uri Binding Właściwość with i tekst hiperlinku z ContentBinding właściwością.The following example shows a DataGridHyperlinkColumn that sets the Uri with the Binding property and the hyperlink text with the ContentBinding property. Hyperlink.ClickZdarzenie jest obsługiwane automatycznie, ponieważ NavigationWindow jest elementem nadrzędnym DataGrid .The Hyperlink.Click event is handled automatically because NavigationWindow is the parent of the DataGrid.

<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

Uwagi

Służy DataGridHyperlinkColumn do wyświetlania danych zawierających Uri , takich jak adres http lub adres e-mail.Use DataGridHyperlinkColumn to display data that contains a Uri, such as an HTTP address or email address. Na poniższej ilustracji przedstawiono przykład DataGridHyperlinkColumn .The following illustration shows an example of a DataGridHyperlinkColumn.

DataGridHyperlinkColumn z adresami e-mailDataGridHyperlinkColumn with email addresses

Uwaga

Hyperlink Nawigacja może wystąpić tylko wtedy, gdy bezpośredni lub pośredni element nadrzędny a Hyperlink jest hostem nawigacji.Hyperlink navigation can only occur if either the direct or indirect parent of a Hyperlink is a navigation host. Przykłady hostów nawigacji obejmują NavigationWindow program, Frame lub dowolną przeglądarkę, która może być hostem XBAPXBAPs , na przykład Microsoft Internet Explorer 6Microsoft Internet Explorer 6 lub nowszą i Firefox 2,0 lub nowszą.Examples of navigation hosts include NavigationWindow, Frame, or any browser that can host XBAPXBAPs, such as Microsoft Internet Explorer 6Microsoft Internet Explorer 6 or later and Firefox 2.0 or later. Aby uzyskać więcej informacji, zobacz temat "hosty nawigacji" w temacie Omówienie nawigacji.For more information, see the "Navigation Hosts" topic in Navigation Overview.

Aby wypełnić kolumnę, powiąż kolumnę z danymi przy Uri użyciu Binding właściwości.To populate the column, bind the column to the Uri data by using the Binding property. Aby wyświetlić tekst hiperłącza, który jest inny niż ciąg identyfikatora URI, powiąż wartość tekstową z ContentBinding właściwością.To display hyperlink text that is different than the URI string, bind the text value to the ContentBinding property. BindingWłaściwość jest stosowana do Hyperlink TextBox elementu or utworzonego w kolumnie.The Binding property is applied to the Hyperlink or TextBox element created in the column. DataContextElement dla elementu w każdej komórce to element danych dla wiersza, w którym znajduje się komórka.The DataContext for the element in each cell is the data item for the row the cell is in. W związku z tym, aby skonfigurować powiązanie, należy ustawić tylko Binding.Path .Therefore, to set up the binding you only have to set the Binding.Path. Opcjonalnie możesz określić, Binding.Converter czy chcesz przekonwertować dane.Optionally, you can specify a Binding.Converter if you want to convert the data. Aby uzyskać więcej informacji na temat powiązania danych, zobacz powiązanie danych (WPF).For more information about data binding, see Data Binding (WPF).

Uwaga

DataGridHyperlinkColumn tworzy Hyperlink element w trybie innym niż Edycja i TextBox element w trybie edycji.DataGridHyperlinkColumn creates a Hyperlink element in the non-editing mode and a TextBox element in the editing mode.

Jeśli chcesz wyświetlić inne typy danych, program DataGrid udostępnia następujące typy kolumn:If you want to display other types of data, DataGrid provides the following column types:

Typ kolumnyColumn Type Wyświetlanie danychData Display
DataGridCheckBoxColumn Służy do wyświetlania danych logicznych.Use to display Boolean data.
DataGridComboBoxColumn Służy do wyświetlania danych wyliczania.Use to display enumeration data.
DataGridTextColumn Użyj, aby wyświetlić tekst.Use to display text.

Jeśli chcesz użyć innych kontrolek w programie DataGrid , możesz utworzyć własne typy kolumn za pomocą polecenia DataGridTemplateColumn .If you want to use other controls in your DataGrid, you can create your own column types by using DataGridTemplateColumn.

Konstruktory

DataGridHyperlinkColumn()

Inicjuje nowe wystąpienie klasy DataGridHyperlinkColumn.Initializes a new instance of the DataGridHyperlinkColumn class.

Pola

TargetNameProperty

Identyfikuje TargetName Właściwość zależności.Identifies the TargetName dependency property.

Właściwości

ActualWidth

Pobiera bieżącą szerokość kolumny w jednostki miary niezależne od urządzenia (1/96 cala na jednostkę)device-independent units (1/96th inch per unit) .Gets the current width of the column, in jednostki miary niezależne od urządzenia (1/96 cala na jednostkę)device-independent units (1/96th inch per unit).

(Odziedziczone po DataGridColumn)
Binding

Pobiera lub ustawia powiązanie, które kojarzy kolumnę z właściwością w źródle danych.Gets or sets the binding that associates the column with a property in the data source.

(Odziedziczone po DataGridBoundColumn)
CanUserReorder

Pobiera lub ustawia wartość wskazującą, czy użytkownik może zmienić położenie wyświetlania kolumny przez przeciągnięcie nagłówka kolumny.Gets or sets a value that indicates whether the user can change the column display position by dragging the column header.

(Odziedziczone po DataGridColumn)
CanUserResize

Pobiera lub ustawia wartość wskazującą, czy użytkownik może dostosować szerokość kolumny za pomocą myszy.Gets or sets a value that indicates whether the user can adjust the column width by using the mouse.

(Odziedziczone po DataGridColumn)
CanUserSort

Pobiera lub ustawia wartość wskazującą, czy użytkownik może sortować kolumnę przez kliknięcie nagłówka kolumny.Gets or sets a value that indicates whether the user can sort the column by clicking the column header.

(Odziedziczone po DataGridColumn)
CellStyle

Pobiera lub ustawia styl używany do renderowania komórek w kolumnie.Gets or sets the style that is used to render cells in the column.

(Odziedziczone po DataGridColumn)
ClipboardContentBinding

Pobiera lub ustawia obiekt powiązania do użycia podczas pobierania lub ustawiania zawartości komórki dla Schowka.Gets or sets the binding object to use when getting or setting cell content for the clipboard.

(Odziedziczone po DataGridBoundColumn)
ContentBinding

Pobiera lub ustawia powiązanie z tekstem hiperlinku.Gets or sets the binding to the text of the hyperlink.

DataGridOwner

Pobiera DataGrid formant, który zawiera tę kolumnę.Gets the DataGrid control that contains this column.

(Odziedziczone po DataGridColumn)
DefaultEditingElementStyle

Wartość domyślna EditingElementStyle właściwości.The default value of the EditingElementStyle property.

DefaultElementStyle

Wartość domyślna ElementStyle właściwości.The default value of the ElementStyle property.

DependencyObjectType

Pobiera DependencyObjectType , który zawija CLRCLR Typ tego wystąpienia.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Odziedziczone po DependencyObject)
Dispatcher

Pobiera Dispatcher ten DispatcherObject program jest skojarzony z.Gets the Dispatcher this DispatcherObject is associated with.

(Odziedziczone po DispatcherObject)
DisplayIndex

Pobiera lub ustawia pozycję wyświetlania kolumny względem innych kolumn w DataGrid .Gets or sets the display position of the column relative to the other columns in the DataGrid.

(Odziedziczone po DataGridColumn)
DragIndicatorStyle

Pobiera lub ustawia obiekt Style, który ma zostać zastosowany do nagłówka kolumny podczas operacji przeciągania.Gets or sets the style object to apply to the column header during a drag operation.

(Odziedziczone po DataGridColumn)
EditingElementStyle

Pobiera lub ustawia styl używany podczas renderowania elementu wyświetlanego w kolumnie dla komórki w trybie edycji.Gets or sets the style that is used when rendering the element that the column displays for a cell in editing mode.

(Odziedziczone po DataGridBoundColumn)
ElementStyle

Pobiera lub ustawia styl używany podczas renderowania elementu wyświetlanego w kolumnie dla komórki, która nie jest w trybie edycji.Gets or sets the style that is used when rendering the element that the column displays for a cell that is not in editing mode.

(Odziedziczone po DataGridBoundColumn)
Header

Pobiera lub ustawia zawartość nagłówka kolumny.Gets or sets the content of the column header.

(Odziedziczone po DataGridColumn)
HeaderStringFormat

Pobiera lub ustawia wzorzec formatu, który ma zostać zastosowany do zawartości nagłówka kolumny.Gets or sets the format pattern to apply to the content of the column header.

(Odziedziczone po DataGridColumn)
HeaderStyle

Pobiera lub ustawia styl używany podczas renderowania nagłówka kolumny.Gets or sets the style that is used when rendering the column header.

(Odziedziczone po DataGridColumn)
HeaderTemplate

Pobiera lub ustawia szablon definiujący wizualną reprezentację nagłówka kolumny.Gets or sets the template that defines the visual representation of the column header.

(Odziedziczone po DataGridColumn)
HeaderTemplateSelector

Pobiera lub ustawia obiekt, który wybiera szablon do użycia w nagłówku kolumny.Gets or sets the object that selects which template to use for the column header.

(Odziedziczone po DataGridColumn)
IsAutoGenerated

Pobiera wartość wskazującą, czy kolumna jest generowana automatycznie.Gets a value that indicates whether the column is auto-generated.

(Odziedziczone po DataGridColumn)
IsFrozen

Pobiera wartość wskazującą, czy kolumna jest nieblokowana pod kątem przewijania w poziomie.Gets a value that indicates whether the column is prevented from scrolling horizontally.

(Odziedziczone po DataGridColumn)
IsReadOnly

Pobiera lub ustawia wartość wskazującą, czy komórki w kolumnie mogą być edytowane.Gets or sets a value that indicates whether cells in the column can be edited.

(Odziedziczone po DataGridColumn)
IsSealed

Pobiera wartość wskazującą, czy to wystąpienie jest aktualnie zapieczętowane (tylko do odczytu).Gets a value that indicates whether this instance is currently sealed (read-only).

(Odziedziczone po DependencyObject)
MaxWidth

Pobiera lub ustawia ograniczenie maksymalnej szerokości kolumny.Gets or sets the maximum width constraint of the column.

(Odziedziczone po DataGridColumn)
MinWidth

Pobiera lub ustawia ograniczenie minimalnej szerokości kolumny.Gets or sets the minimum width constraint of the column.

(Odziedziczone po DataGridColumn)
SortDirection

Pobiera lub ustawia kierunek sortowania (rosnący lub malejący) kolumny.Gets or sets the sort direction (ascending or descending) of the column.

(Odziedziczone po DataGridColumn)
SortMemberPath

Pobiera lub ustawia nazwę właściwości lub rozdzielaną kropkami hierarchię nazw właściwości, która wskazuje składową, według której ma zostać wykonane sortowanie.Gets or sets a property name, or a period-delimited hierarchy of property names, that indicates the member to sort by.

(Odziedziczone po DataGridColumn)
TargetName

Pobiera lub ustawia nazwę docelowego okna lub ramki dla hiperlinku.Gets or sets the name of a target window or frame for the hyperlink.

Visibility

Pobiera lub ustawia widoczność kolumny.Gets or sets the visibility of the column.

(Odziedziczone po DataGridColumn)
Width

Pobiera lub ustawia szerokość kolumny lub tryb automatycznej zmiany rozmiarów.Gets or sets the column width or automatic sizing mode.

(Odziedziczone po DataGridColumn)

Metody

CancelCellEdit(FrameworkElement, Object)

Powoduje, że edytowana komórka kolumny zostanie przywrócona do określonej wartości.Causes the column cell being edited to revert to the specified value.

CancelCellEdit(FrameworkElement, Object)

Powoduje, że edytowana komórka przywraca pierwotną, nieedytowaną wartość.Causes the cell being edited to revert to the original, unedited value.

(Odziedziczone po DataGridColumn)
CheckAccess()

Określa, czy wątek wywołujący ma dostęp do tego DispatcherObject .Determines whether the calling thread has access to this DispatcherObject.

(Odziedziczone po DispatcherObject)
ClearValue(DependencyProperty)

Czyści wartość lokalną właściwości.Clears the local value of a property. Właściwość, która ma zostać wyczyszczona, jest określana przez DependencyProperty Identyfikator.The property to be cleared is specified by a DependencyProperty identifier.

(Odziedziczone po DependencyObject)
ClearValue(DependencyPropertyKey)

Czyści wartość lokalną właściwości tylko do odczytu.Clears the local value of a read-only property. Właściwość, która ma zostać wyczyszczona, jest określana przez DependencyPropertyKey .The property to be cleared is specified by a DependencyPropertyKey.

(Odziedziczone po DependencyObject)
CoerceValue(DependencyProperty)

Przekształca wartość określonej właściwości zależności.Coerces the value of the specified dependency property. Jest to realizowane przez wywołanie dowolnej CoerceValueCallback funkcji określonej w metadanych właściwości dla właściwości zależności, która istnieje w wywołaniu DependencyObject .This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Odziedziczone po DependencyObject)
CommitCellEdit(FrameworkElement)

Wykonuje wszystkie wymagane walidacje przed wyjściem z trybu edycji.Performs any required validation before exiting edit mode.

CommitCellEdit(FrameworkElement)

Wykonuje wszystkie wymagane walidacje przed wyjściem z trybu edycji komórki.Performs any required validation before exiting cell editing mode.

(Odziedziczone po DataGridColumn)
Equals(Object)

Określa, czy podana DependencyObject jest równoważna z bieżącym DependencyObject .Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Odziedziczone po DependencyObject)
GenerateEditingElement(DataGridCell, Object)

Pobiera edytowalny TextBox element, który jest powiązany z ContentBinding wartością właściwości kolumny.Gets an editable TextBox element that is bound to the column's ContentBinding property value.

GenerateElement(DataGridCell, Object)

Pobiera element tylko do odczytu Hyperlink , który jest powiązany z ContentBinding wartością właściwości kolumny.Gets a read-only Hyperlink element that is bound to the column's ContentBinding property value.

GetCellContent(DataGridRow)

Pobiera Content wartość właściwości dla komórki na przecięciu tej kolumny i określonego wiersza.Retrieves the Content property value for the cell at the intersection of this column and the specified row.

(Odziedziczone po DataGridColumn)
GetCellContent(Object)

Pobiera Content wartość właściwości dla komórki na przecięciu tej kolumny i wiersz reprezentujący określony element danych.Gets the Content property value for the cell at the intersection of this column and the row that represents the specified data item.

(Odziedziczone po DataGridColumn)
GetHashCode()

Pobiera kod skrótu dla tego elementu DependencyObject .Gets a hash code for this DependencyObject.

(Odziedziczone po DependencyObject)
GetLocalValueEnumerator()

Tworzy wyspecjalizowany moduł wyliczający służący do określania, które właściwości zależności mają lokalnie ustawione wartości DependencyObject .Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Odziedziczone po DependencyObject)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
GetValue(DependencyProperty)

Zwraca bieżącą obowiązującą wartość właściwości zależności w tym wystąpieniu DependencyObject .Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Odziedziczone po DependencyObject)
InvalidateProperty(DependencyProperty)

Ponowna ocenuje wartość efektywną dla określonej właściwości zależności.Re-evaluates the effective value for the specified dependency property.

(Odziedziczone po DependencyObject)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
NotifyPropertyChanged(String)

Powiadamia, DataGrid że zawiera tę kolumnę, która została zmieniona przez właściwość kolumny.Notifies the DataGrid that contains this column that a column property has changed.

(Odziedziczone po DataGridColumn)
OnBindingChanged(BindingBase, BindingBase)

Powiadamia, DataGrid gdy wartość Binding właściwości zostanie zmieniona.Notifies the DataGrid when the value of the Binding property changes.

(Odziedziczone po DataGridBoundColumn)
OnCoerceIsReadOnly(Boolean)

Określa wartość IsReadOnly właściwości na podstawie reguł właściwości z siatki danych, która zawiera tę kolumnę.Determines the value of the IsReadOnly property based on property rules from the data grid that contains this column.

(Odziedziczone po DataGridBoundColumn)
OnContentBindingChanged(BindingBase, BindingBase)

Powiadamia o DataGrid ContentBinding zmianie właściwości.Notifies the DataGrid when the ContentBinding property changes.

OnCopyingCellClipboardContent(Object)

Podnosi CopyingCellClipboardContent zdarzenie.Raises the CopyingCellClipboardContent event.

(Odziedziczone po DataGridColumn)
OnPastingCellClipboardContent(Object, Object)

Podnosi PastingCellClipboardContent zdarzenie.Raises the PastingCellClipboardContent event.

(Odziedziczone po DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Wywoływana za każdym razem, gdy wartość skuteczna każdej właściwości zależności na tej stronie DependencyObject została zaktualizowana.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Określona właściwość zależności, która została zmieniona, jest raportowana w danych zdarzenia.The specific dependency property that changed is reported in the event data.

(Odziedziczone po DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)

Wywołuje się, gdy komórka w kolumnie przechodzi do trybu edycji.Called when a cell in the column enters editing mode.

ReadLocalValue(DependencyProperty)

Zwraca wartość lokalną właściwości zależności, jeśli istnieje.Returns the local value of a dependency property, if it exists.

(Odziedziczone po DependencyObject)
RefreshCellContent(FrameworkElement, String)

Odświeża zawartość komórki w kolumnie w odpowiedzi na zmianę wartości właściwości Column.Refreshes the contents of a cell in the column in response to a column property value change.

SetCurrentValue(DependencyProperty, Object)

Ustawia wartość właściwości zależności bez zmiany jego źródła wartości.Sets the value of a dependency property without changing its value source.

(Odziedziczone po DependencyObject)
SetValue(DependencyProperty, Object)

Ustawia wartość lokalną właściwości zależności, określoną za pomocą identyfikatora właściwości zależności.Sets the local value of a dependency property, specified by its dependency property identifier.

(Odziedziczone po DependencyObject)
SetValue(DependencyPropertyKey, Object)

Ustawia wartość lokalną właściwości zależności tylko do odczytu, określoną przez DependencyPropertyKey Identyfikator właściwości zależności.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Odziedziczone po DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość dla podanej właściwości zależności.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Odziedziczone po DependencyObject)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
VerifyAccess()

Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObject .Enforces that the calling thread has access to this DispatcherObject.

(Odziedziczone po DispatcherObject)

Zdarzenia

CopyingCellClipboardContent

Występuje po przygotowaniu zawartości Schowka komórki.Occurs after the cell clipboard content is prepared.

(Odziedziczone po DataGridColumn)
PastingCellClipboardContent

Występuje przed przeniesieniem zawartości schowka do komórki.Occurs before the clipboard content is moved to the cell.

(Odziedziczone po DataGridColumn)

Dotyczy

Zobacz też