Xamarin.Forms Giriş Öğreticisi

Makale
Developer (Başlangıç)
Tamamlanması için 8 dakika kaldı

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

7 dakika kaldı

Visual Studio
Mac için Visual Studio

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.Forms uygulamanı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çindeki Entry 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.

Bu öğreticiyi tamamlamak için iOS ve Android platformu desteğine sahip Mac için Visual Studio (son sürüm) uygulamasını yüklemiş olmanız gerekir. Ayrıca Xcode (son sürüm) uygulaması da gereklidir. Xamarin platformunu yükleme hakkında daha bilgi için bkz. Xamarin'i Yükleme.

Mac için Visual Studio 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.Forms uygulamanın Xamarin.Forms anatomisi.
Çözüm Bölmesi'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çindeki Entry bileşeninden oluşur. Entry.Placeholder özelliği, Entry ilk kez görüntülendiğinde gösterilen yer tutucu metnini belirtir.
Mac için 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:

Mac için Visual Studio'da uygulamayı durdurun.

Metin değişikliklerine yanıt verme

5 dakika kaldı

Visual Studio
Mac için Visual Studio

MainPage.xaml içinde Entry bildirimini değiştirerek TextChanged ve Completed 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ı da OnEntryCompleted 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 ve OnEntryCompleted 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ğinde OnEntryTextChanged yöntemi yürütülür. sender bağımsız değişkeni, TextChanged olayının gerçekleştirilmesinden sorumlu olan Entry nesnesidir ve Entry 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ızda OnEntryCompleted yöntemi yürütülür. sender bağımsız değişkeni, TextChanged olayının gerçekleştirilmesinden sorumlu olan Entry nesnesidir ve Entry nesnesine erişmek için kullanılabilir.

Önemli

Entry içine girilen metinler Text özelliğinde depolanır.
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 ve TextChanged ile Completed 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.

MainPage.xaml içinde Entry bildirimini değiştirerek TextChanged ve Completed 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ı da OnEntryCompleted adlı bir olay işleyicisine ayarlar. İki olay işleyicisi de bir sonraki adımda oluşturulacaktır.
Çözüm Bölmesi'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 ve OnEntryCompleted 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ğinde OnEntryTextChanged yöntemi yürütülür. sender bağımsız değişkeni, TextChanged olayının gerçekleştirilmesinden sorumlu olan Entry nesnesidir ve Entry 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ızda OnEntryCompleted yöntemi yürütülür. sender bağımsız değişkeni, TextChanged olayının gerçekleştirilmesinden sorumlu olan Entry nesnesidir ve Entry nesnesine erişmek için kullanılabilir.

Önemli

Entry içine girilen metinler Text özelliğinde depolanır.
Mac için 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 ve TextChanged ile Completed 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

2 dakika kaldı

Visual Studio
Mac için Visual Studio

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ırlarken IsSpellCheckEnabled özelliği ise yazım denetimini devre dışı bırakmak için false olarak ayarlanmıştır. Benzer şekilde IsTextPredictionEnabled özelliği, metin tahmini ve otomatik metin tahmini özelliklerini devre dışı bırakmak için false olarak ayarlanmıştır. Bunlara ek olarak IsPassword ö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.

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ırlarken IsSpellCheckEnabled özelliği ise yazım denetimini devre dışı bırakmak için false olarak ayarlanmıştır. Benzer şekilde IsTextPredictionEnabled özelliği, metin tahmini ve otomatik metin tahmini özelliklerini devre dışı bırakmak için false olarak ayarlanmıştır. Bunlara ek olarak IsPassword ö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 Mac için 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. 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:

Mac için Visual Studio'da uygulamayı durdurun.

Davranışı özelleştirme Entry hakkında daha fazla bilgi için Giriş kılavuzuna Xamarin.Forms bakın.

Xamarin.Forms Giriş Öğreticisi

Giriş oluşturma

Metin değişikliklerine yanıt verme

Davranışı özelleştirme

Tebrikler!

Sonraki adımlar

Xamarin.Forms Giriş Öğreticisi

Giriş oluşturma

Metin değişikliklerine yanıt verme

Davranışı özelleştirme

Tebrikler!

Sonraki adımlar

İlgili bağlantılar