Binding Sınıf

Tanım

Bağlama hedef nesnelerinin (genellikle, WPF öğeleri) ve herhangi bir veri kaynağının (örneğin, veritabanı, XML dosyası veya veri içeren herhangi bir nesne) özelliklerini bağlayan bağlama tanımına üst düzey erişim sağlar.

public ref class Binding : System::Windows::Data::BindingBase
public class Binding : System.Windows.Data.BindingBase
type Binding = class
    inherit BindingBase
Public Class Binding
Inherits BindingBase
Devralma

Açıklamalar

Windows Presentation Foundation (WPF) veri bağlaması, uygulamaların veri sunması ve verilerle etkileşim kurması için basit ve tutarlı bir yol sağlar. Veri bağlama, iki farklı nesnenin özelliklerinin değerlerini eşitlemenizi sağlar.

Bağlama oluşturmak için sınıfını Binding veya devralan BindingBasediğer sınıflardan birini kullanın. Hangi nesneyi bağladığınıza ve veri kaynağınızın yapısına bakılmaksızın, her bağlama aşağıdaki şekilde gösterilen modeli izler.

Temel veri bağlama diyagramı

Şekilde aşağıdaki temel WPF veri bağlama kavramları gösterilmektedir.

  • Her bağlama genellikle şu dört bileşene sahiptir: bağlama hedef nesnesi, hedef özellik, bağlama kaynağı ve Path kullanılacak bağlama kaynağındaki değere. Örneğin, öğesinin TextBox içeriğini bir Employee nesnesinin Name özelliğine bağlamak istiyorsanız, hedef nesneniz TextBox, hedef özelliği Text özelliği, kullanılacak değer Ad ve kaynak nesne de Employee nesnesidir.

  • Hedef özellik bir bağımlılık özelliği olmalıdır. Bu aynı zamanda bir alanı bağlayamayacağınız anlamına gelir. Nesnelerin özelliklerinin UIElement çoğu bağımlılık özellikleridir ve salt okunur olanlar dışında çoğu bağımlılık özelliği varsayılan olarak veri bağlamayı destekler. (Yalnızca DependencyObject türler bağımlılık özelliklerini tanımlayabilir ve tüm UIElement nesneler öğesinden DependencyObjecttüretilebilir.)

  • Şekilde belirtilmemiş olsa da, bağlama kaynak nesnesinin özel bir CLR nesnesi olmakla sınırlı olmadığı belirtilmelidir. WPF veri bağlama, CLR nesneleri ve XML biçimindeki verileri destekler. Bazı örnekler sağlamak için bağlama kaynağınız bir , herhangi bir UIElementliste nesnesi, ADO.NET verileri veya Web Hizmetleri ile ilişkilendirilmiş bir CLR nesnesi ya da XML verilerinizi içeren bir XmlNode olabilir.

Veri akışının Mode yönünü belirtmek için özelliğini kullanın. Kaynak değişikliklerini tek yönlü veya iki yönlü bağlamalarda algılamak için, kaynağın gibi INotifyPropertyChangeduygun bir özellik değişiklik bildirim mekanizması uygulaması gerekir. Örnek için bkz . Nasıl yapılır: Özellik Değişikliği Bildirimi Uygulama. UpdateSourceTrigger özelliği kaynak güncelleştirmelerinin zamanlamasını belirtir. Daha fazla bilgi için Bkz. Veri Bağlamaya Genel Bakış bölümündeki "Temel Veri Bağlama Kavramları".

XAML Öznitelik Kullanımı

<object property="{Binding  declaration}"/>  

XAML Değerleri

Bildirim
Virgülle (,) ayrılmış sıfır veya daha fazla öznitelik atama yan tümcesi. Daha fazla bilgi için bkz . Bağlama İşaretleme Uzantısı veya Bağlama Bildirimlerine Genel Bakış.

Oluşturucular

Binding()

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

Binding(String)

başlangıç yolu ile sınıfının yeni bir örneğini Binding başlatır.

Alanlar

DoNothing

Bağlama altyapısına herhangi bir eylem gerçekleştirmemelerini bildirmek için döndürülen bir değer olarak kullanılır.

IndexerName

PropertyName PropertyChangedEventArgs dizin oluşturucu özelliğinin değiştiğini belirtmek için olarak kullanılır.

SourceUpdatedEvent

Ekli SourceUpdated olayı tanımlar.

TargetUpdatedEvent

Ekli TargetUpdated olayı tanımlar.

XmlNamespaceManagerProperty

XmlNamespaceManager Ekli özelliği tanımlar.

Özellikler

AsyncState

Zaman uyumsuz veri dağıtıcısına geçirilen opak verileri alır veya ayarlar.

BindingGroupName

Bu bağlamanın ait olduğu öğesinin BindingGroup adını alır veya ayarlar.

(Devralındığı yer: BindingBase)
BindsDirectlyToSource

Veri öğesine veya nesneye göre değerlendirme Path yapılıp yapılmayacağını belirten bir değer alır veya DataSourceProvider ayarlar.

Converter

Kullanılacak dönüştürücüsü alır veya ayarlar.

ConverterCulture

Dönüştürücüsü değerlendirilecek kültürü alır veya ayarlar.

ConverterParameter

parametresini öğesine geçirmek Converteriçin alır veya ayarlar.

Delay

Hedefteki değer değiştikten sonra bağlama kaynağını güncelleştirmeden önce beklenmesi için milisaniye cinsinden süreyi alır veya ayarlar.

(Devralındığı yer: BindingBase)
ElementName

Bağlama kaynak nesnesi olarak kullanılacak öğenin adını alır veya ayarlar.

FallbackValue

Bağlama bir değer döndüremediğinde kullanılacak değeri alır veya ayarlar.

(Devralındığı yer: BindingBase)
IsAsync

değerlerinin zaman uyumsuz olarak alınıp alınmayacağını ve ayarlanıp ayarlanmayacağını Binding belirten bir değeri alır veya ayarlar.

Mode

Bağlamadaki veri akışının yönünü gösteren bir değer alır veya ayarlar.

NotifyOnSourceUpdated

Bağlama hedefinden bağlama kaynağına bir değer aktarıldığında olayı tetikleyip tetiklemeyeceğini SourceUpdated belirten bir değer alır veya ayarlar.

NotifyOnTargetUpdated

Bağlama kaynağından bağlama hedefine bir değer aktarıldığında olayı tetikleyip tetiklemeyeceğini TargetUpdated belirten bir değer alır veya ayarlar.

NotifyOnValidationError

bağlı nesnede ekli olayın yükseltilip yükseltmeyeceğini Error belirten bir değer alır veya ayarlar.

Path

Bağlama kaynağı özelliğinin yolunu alır veya ayarlar.

RelativeSource

Bağlama hedefinin konumuna göre konumunu belirterek bağlama kaynağını alır veya ayarlar.

Source

Bağlama kaynağı olarak kullanılacak nesneyi alır veya ayarlar.

StringFormat

Bağlı değeri bir dize olarak görüntülerse bağlamanın nasıl biçimlendirildiğini belirten bir dize alır veya ayarlar.

(Devralındığı yer: BindingBase)
TargetNullValue

Kaynağın nulldeğeri olduğunda hedefte kullanılan değeri alır veya ayarlar.

(Devralındığı yer: BindingBase)
UpdateSourceExceptionFilter

Bağlama altyapısının bağlama kaynak değerinin güncelleştirmesi sırasında karşılaştığı özel durumları işlemek için özel mantık sağlamak için kullanabileceğiniz bir işleyici alır veya ayarlar. Bu yalnızca bağlamanızla ilişkilendirdiğiniz durumlarda ExceptionValidationRule geçerlidir.

UpdateSourceTrigger

Bağlama kaynağı güncelleştirmelerinin zamanlamasını belirleyen bir değer alır veya ayarlar.

ValidatesOnDataErrors

öğesinin dahil DataErrorValidationRuleedilip edilmeyeceğini belirten bir değer alır veya ayarlar.

ValidatesOnExceptions

öğesinin dahil ExceptionValidationRuleedilip edilmeyeceğini belirten bir değer alır veya ayarlar.

ValidatesOnNotifyDataErrors

öğesinin dahil NotifyDataErrorValidationRuleedilip edilmeyeceğini belirten bir değer alır veya ayarlar.

ValidationRules

Kullanıcı girişinin geçerliliğini denetleen bir kural koleksiyonu alır.

XPath

Kullanılacak XML bağlama kaynağındaki değeri döndüren bir XPath sorguyu alır veya ayarlar.

İliştirilmiş Özellikler

XmlNamespaceManager

XML bağlamalarında ad alanı algılayan XPath sorgular gerçekleştirmek için kullanılan öğesini alır veya ayarlarXmlNamespaceManager.

Yöntemler

AddSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)

Ekli olay için SourceUpdated bir işleyici ekler.

AddTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)

Ekli olay için TargetUpdated bir işleyici ekler.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
GetXmlNamespaceManager(DependencyObject)

Belirtilen nesneye bağlı bağlama tarafından kullanılan bir XML ad alanı yöneticisi nesnesi döndürür.

MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
ProvideValue(IServiceProvider)

Bu bağlama ve uzantının uygulandığı özellikte ayarlanması gereken bir nesne döndürür.

(Devralındığı yer: BindingBase)
RemoveSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)

Ekli olay için bir işleyici kaldırır SourceUpdated .

RemoveTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)

Ekli olay için bir işleyici kaldırır TargetUpdated .

SetXmlNamespaceManager(DependencyObject, XmlNamespaceManager)

Sağlanan öğeye eklenmiş bağlama tarafından kullanılan bir ad alanı yöneticisi nesnesi ayarlar.

ShouldSerializeFallbackValue()

Serileştirme işlemlerinin bu sınıfın örneklerinde özelliğin etkin değerini serileştirmesi FallbackValue gerekip gerekmediğini belirten bir değer döndürür.

(Devralındığı yer: BindingBase)
ShouldSerializePath()

Özelliğin Path kalıcı olup olmayacağını gösterir.

ShouldSerializeSource()

Özelliğin Source kalıcı olup olmayacağını gösterir.

ShouldSerializeTargetNullValue()

Özelliğin seri hale getirilip getirilmeyeceğini TargetNullValue belirten bir değer döndürür.

(Devralındığı yer: BindingBase)
ShouldSerializeValidationRules()

Özelliğin ValidationRules kalıcı olup olmayacağını gösterir.

ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)

İliştirilmiş Olaylar

SourceUpdated

Bir değer bağlama hedefinden bağlama kaynağına aktarıldığında, ancak yalnızca değerine ayarlanmış truebağlamalar NotifyOnSourceUpdated için gerçekleşir.

TargetUpdated

Bir değer bağlama kaynağından bağlama hedefine aktarıldığında gerçekleşir, ancak yalnızca değerine ayarlanmış truebağlamalar NotifyOnTargetUpdated için gerçekleşir.

Şunlara uygulanır

Ayrıca bkz.