Xamarin.Forms Giriş Öğreticisi
Bu öğreticiye başlamadan önce şunları başarıyla tamamlamış olmanız gerekir:
- İlk Xamarin.Forms uygulama hızlı başlangıcınızı oluşturun.
- StackLayout öğreticisi.
Bu öğreticide aşağıdakilerin nasıl yapılacağını öğreneceksiniz:
- XAML içinde bir Xamarin.Forms
Entry
oluşturun. Entry
içindeki metin değişikliklerine yanıt verme.Entry
davranışını özelleştirme.
Bir Entry
davranışını özelleştirmeyi gösteren basit bir uygulama oluşturmak için Visual Studio 2019 veya Mac için Visual Studio kullanacaksınız. Aşağıdaki ekran görüntüleri, son uygulamayı gösterir:
Ayrıca uygulamanızı yeniden oluşturmadan kullanıcı arabirimi değişikliklerini görmek için için Xamarin.Forms XAML Çalışırken Yeniden Yükleme kullanacaksınız.
Giriş oluşturma
Bu öğreticiyi tamamlamak için Visual Studio 2019 (son sürüm) ve .NET ile mobil uygulama geliştirme iş yükü sisteminizde yüklü olmalıdır. Ayrıca öğretici uygulamasını iOS üzerinde derleyebilmek için eşleştirilmiş bir Mac de gerekecektir. Xamarin platformunu yükleme hakkında bilgi için bkz. Xamarin'i Yükleme. Visual Studio 2019'u bir Mac derleme ana bilgisayarına bağlama hakkında bilgi için bkz. Xamarin.iOS geliştirme için Mac ile eşleştirme.
Visual Studio'yu başlatın ve EntryTutorial adlı yeni bir boş Xamarin.Forms uygulama oluşturun.
Önemli
Bu öğreticide kullanılan C# ve XAML kod parçacıklarında çözüm adı EntryTutorial olarak belirlenmiştir. Farklı bir ad kullanırsanız bu öğreticideki kodları çözüme kopyaladığınızda derleme hatalarıyla karşılaşabilirsiniz.
Oluşturulan .NET Standard kitaplığı hakkında daha fazla bilgi için Bkz. Hızlı Başlangıç Ayrıntılı Bakış'taXamarin.Formsuygulamanın Xamarin.Forms anatomisi.
Çözüm Gezgini'ndeki EntryTutorial projesinde MainPage.xaml dosyasına çift tıklayıp açın. Ardından MainPage.xaml içindeki şablon kodunun tamamını silip aşağıdaki kodu ekleyin:
<?xml version="1.0" encoding="utf-8"?> <ContentPage xmlns="http://xamarin.com/schemas/2014/forms" xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml" x:Class="EntryTutorial.MainPage"> <StackLayout Margin="20,35,20,20"> <Entry Placeholder="Enter text" /> </StackLayout> </ContentPage>
Bu kod, sayfa için kullanıcı arabirimini bildirimli bir şekilde tanımlar ve bu da bir
StackLayout
içindekiEntry
bileşeninden oluşur.Entry.Placeholder
özelliği,Entry
ilk kez görüntülendiğinde gösterilen yer tutucu metnini belirtir.Visual Studio araç çubuğunda Başlat düğmesine (Oynat düğmesine benzeyen üçgen düğme) basarak uygulamayı seçtiğiniz iOS simülatöründe veya Android öykünücüsünde başlatın:
Visual Studio'da uygulamayı durdurun.
Metin değişikliklerine yanıt verme
MainPage.xaml içinde
Entry
bildirimini değiştirerekTextChanged
veCompleted
olayları için bir işleyici ayarlamasını sağlayın:<Entry Placeholder="Enter text" TextChanged="OnEntryTextChanged" Completed="OnEntryCompleted" />
Bu kod,
TextChanged
olayınıOnEntryTextChanged
adlı bir olay işleyicisine,Completed
olayını daOnEntryCompleted
adlı bir olay işleyicisine ayarlar. İki olay işleyicisi de bir sonraki adımda oluşturulacaktır.Çözüm Gezgini'ndeki EntryTutorial projesinde MainPage.xaml bölümünü genişlettikten sonra MainPage.xaml.cs dosyasına çift tıklayıp açın. Ardından MainPage.xaml.cs içinde sınıfa
OnEntryTextChanged
veOnEntryCompleted
olay işleyicilerini ekleyin:void OnEntryTextChanged(object sender, TextChangedEventArgs e) { string oldText = e.OldTextValue; string newText = e.NewTextValue; } void OnEntryCompleted(object sender, EventArgs e) { string text = ((Entry)sender).Text; }
Entry
içindeki metin değiştiğindeOnEntryTextChanged
yöntemi yürütülür.sender
bağımsız değişkeni,TextChanged
olayının gerçekleştirilmesinden sorumlu olanEntry
nesnesidir veEntry
nesnesine erişmek için kullanılabilir.TextChangedEventArgs
bağımsız değişkeni, metin değiştirilmeden önce ve değiştirildikten sonra elde edilen eski ve yeni metin değerlerini sağlar.Enter tuşuna basarak
Entry
içine metin girmeyi tamamladığınızdaOnEntryCompleted
yöntemi yürütülür.sender
bağımsız değişkeni,TextChanged
olayının gerçekleştirilmesinden sorumlu olanEntry
nesnesidir veEntry
nesnesine erişmek için kullanılabilir.Visual Studio araç çubuğunda Başlat düğmesine (Oynat düğmesine benzeyen üçgen düğme) basarak uygulamayı seçtiğiniz iOS simülatöründe veya Android öykünücüsünde başlatın:
İki olay işleyicisinde kesme noktası ayarlayın,
Entry
içine metin girin veTextChanged
ileCompleted
olaylarının başlatıldığına dikkat edin.Olaylar hakkında
Entry
daha fazla bilgi için Giriş kılavuzundaki Olaylar ve etkileşim bölümüne Xamarin.Forms bakın.
Davranışı özelleştirme
MainPage.xaml dosyasında
Entry
bildirimini değiştirerek davranışını özelleştirin:<Entry Placeholder="Enter password" MaxLength="15" IsSpellCheckEnabled="false" IsTextPredictionEnabled="false" IsPassword="true" />
Bu kod,
Entry
davranışını özelleştiren özellikleri ayarlar.MaxLength
özelliği,Entry
için izin verilen giriş uzunluğunu sınırlarkenIsSpellCheckEnabled
özelliği ise yazım denetimini devre dışı bırakmak içinfalse
olarak ayarlanmıştır. Benzer şekildeIsTextPredictionEnabled
özelliği, metin tahmini ve otomatik metin tahmini özelliklerini devre dışı bırakmak içinfalse
olarak ayarlanmıştır. Bunlara ek olarakIsPassword
özelliği, girilen karakterlerin parola karakteriyle (siyah daire) maskelenmesini sağlamaktadır.Not
Parola girme gibi bazı metin giriş senaryolarında yazım denetimi ve metin tahmini olumsuz deneyime neden olabileceği için devre dışı bırakılmalıdır.
Uygulama çalışıyorsa dosyada yaptığınız değişiklikleri kaydettiğinizde simülatör veya öykünücü içindeki uygulama kullanıcı arabirimi otomatik olarak güncelleştirilir. Aksi takdirde Visual Studio araç çubuğunda Başlat düğmesine (Oynat düğmesine benzeyen üçgen düğme) basarak uygulamayı seçtiğiniz uzak iOS simülatöründe veya Android öykünücüsünde başlatın.
Entry
içine metin girin ve her karakterin parola maskeleme karakteriyle değiştirildiğine ve girilebilecek maksimum karakter sayısının 15 olduğuna dikkat edin:Visual Studio'da uygulamayı durdurun.
Davranışı özelleştirme
Entry
hakkında daha fazla bilgi için Giriş kılavuzuna Xamarin.Forms bakın.
Tebrikler!
Tebrikler, bu öğreticiyi tamamlayarak aşağıdakilerin nasıl yapıldığını öğrendiniz:
- XAML içinde bir Xamarin.Forms
Entry
oluşturun. Entry
içindeki metin değişikliklerine yanıt verme.Entry
davranışını özelleştirme.
Sonraki adımlar
ile Xamarin.Formsmobil uygulama oluşturmanın temelleri hakkında daha fazla bilgi edinmek için Düzenleyici öğreticisine geçin.
İlgili bağlantılar
Bu bölümle ilgili bir sorununuz mu var? Öyleyse bu bölümü iyileştirebilmemiz için lütfen geri bildirimde bulunun.