Label

Form üzerinde sabit bir yazı göstermek için kullanılan nesnedir. Başlık, açıklama ya da bir alanın yanındaki bilgilendirme metni gibi, kullanıcının değiştiremeyeceği yazılar için kullanılır.

Değer tipi: Bu nesnenin bir değeri yoktur. Label salt görsel bir nesnedir; veri tutmaz, veritabanına bir alan yazmaz. Gösterdiği yazıyı Text özelliğiyle yönetirsiniz.

Ne zaman kullanılır?

Formda sabit bir metin göstermek istediğinizde kullanın: bölüm başlığı, bir alanın açıklaması, kısa bir uyarı notu. Kullanıcının veri gireceği bir alan gerekiyorsa TextBox, bölümleri görsel olarak ayırmak istiyorsanız Divider daha uygundur.

Tasarımcı özellikleri

Bir Label seçildiğinde Özellik Görüntüleyici sekmelere ayrılır.

General

Özellik	Açıklama
Name	Nesnenin koddaki adı (ör. Label1). Koddan bu adla erişirsiniz.

Behavior

Özellik	Açıklama
Font	Yazı tipi, kalın / italik / altı çizili ve punto ayarları.
Height	Nesnenin yüksekliği.
Line Height	Satır yüksekliği; çok satırlı yazıda satır aralığını ayarlar.
ReadOnly	Nesneyi salt okunur yapar.
Required	Nesneyi zorunlu olarak işaretler.
Tab Index	Tab tuşuyla geçiş sırasını belirler.

Appearance

Özellik	Açıklama
Text	Nesnenin gösterdiği yazı (çok dilli olabilir). En çok kullanılan özelliktir.
Title	Fareyle üzerine gelince çıkan ipucu yazısı (çok dilli olabilir).
Text Align	Yazının yatay hizası (sola / ortaya / sağa).
Visible / Client Visible	Nesnenin görünürlüğü.
Enabled / Client Enabled	Nesnenin aktif olup olmadığı.

Olaylar

Bir nesne açılırken olaylar belirli bir sırayla tetiklenir. Doğru kodu doğru olaya yazmak için bu sırayı bilmek işinizi kolaylaştırır.

Açılış sırası: OnInit → OnLoad → OnDataLoad → OnPreRender → OnRender

Olaylar iki tarafta çalışabilir: sunucu olayları C# kodunda, istemci olayları tarayıcıdaki TypeScript kodunda. Label salt görsel bir nesne olduğu için olaylar nadiren kullanılır; çoğu zaman Text özelliğini koddan değiştirmek yeterlidir.

Sunucu olayları (Server)

Olay	Ne zaman çalışır
OnInit	Form açılırken nesne oluşturulduğunda, en başta.
OnLoad	OnInit'in hemen ardından, nesne yüklenince.
OnRender	Nesne ekrana çizilirken.
OnValidating	Nesne doğrulanırken.
OnValueChanging	Değer değişmeden hemen önce (iptal edilebilir).
OnValueChanged	Değer değiştikten hemen sonra.

İstemci olayları (Client)

Sunucudaki olaylara ek olarak tarayıcı tarafında şunlar da vardır:

Olay	Ne zaman çalışır
OnDataLoad	Nesnenin verisi yüklendiğinde.
OnPreRender	Nesne ekrana çizilmeden hemen önce.
OnClick / OnDoubleClick	Nesneye tıklanınca / çift tıklanınca.
OnPropertyChanging / OnPropertyChanged	Bir özellik kodla değiştirilmeden önce / sonra.

Kod örnekleri

Label'ın bir değeri olmadığı için ondan değer okuyup yazmazsınız; gösterdiği yazıyı Text özelliğiyle değiştirirsiniz. Sunucu örnekleri turuncu, istemci örnekleri kırmızı çerçevelidir.

Form kodu (C#, sunucu)

Form kodunda nesneye doğrudan adıyla erişirsiniz:

// Yazıyı oku
string baslik = Label1.Text.ToString();

// Yazıyı değiştir
Label1.Text = "Talep Bilgileri";

// Gizle / göster
Label1.Visible = false;

Akış (Flow) kodu (C#, sunucu)

Akış kodunda nesneye Document1.Controls üzerinden erişirsiniz:

// Yazıyı değiştir
Document1.Controls["Label1"].Text = "Talep Bilgileri";

// Gizle
Document1.Controls["Label1"].Visible = false;

İstemci kodu (TypeScript, tarayıcı)

İstemci tarafında nesnelere this. ile erişilir ve özellik adları küçük harfle yazılır (text, visible):

// Yazıyı değiştir
this.Label1.text = "Talep Bilgileri";

// Gizle / göster
this.Label1.visible = false;

Label'ı dinamik başlık olarak kullanma

Label'ın Text özelliğini koddan değiştirerek dinamik başlıklar oluşturabilirsiniz. Örneğin bir TextBox'ın OnValueChanged olayında this.Label1.text = "Sayın " + this.TextBox1.value; yazarak başlığı kullanıcının girdiği ada göre güncelleyebilirsiniz.

İpuçları

• Label kullanıcının değiştiremeyeceği sabit yazılar içindir. Kullanıcının veri gireceği bir alan gerekiyorsa TextBox kullanın.
• Uzun bilgilendirme metinlerinde Line Height ile satır aralığını ayarlayarak okunabilirliği artırabilirsiniz.
• Text çok dilli olduğu için, farklı dillerdeki kullanıcılar için ayrı karşılıklar tanımlayabilirsiniz.

Tüm tasarımcı özellikleri (tam liste)

General: Name

Behavior: Font, Height, Line Height, ReadOnly, Required, Tab Index

Appearance: Text, Title, Text Align, Visible, Client Visible, Enabled, Client Enabled

Olaylar (Server): OnInit, OnLoad, OnRender, OnValidating, OnValueChanging, OnValueChanged

Olaylar (Client): OnInit, OnLoad, OnPreRender, OnRender, OnDataLoad, OnClick, OnDoubleClick, OnPropertyChanging, OnPropertyChanged, OnValidating, OnValueChanging, OnValueChanged