Bu tarayıcı artık desteklenmiyor.
En son özelliklerden, güvenlik güncelleştirmelerinden ve teknik destekten faydalanmak için Microsoft Edge’e yükseltin.
Bir sınıfın, yapının, arabirimin veya yöntemin tanımını iki veya daha fazla kaynak dosyaya bölmek mümkündür. Her kaynak dosya türün veya yöntem tanımının bir bölümünü içerir ve uygulama derlendiğinde tüm bölümler birleştirilir.
Sınıf tanımını bölmenin istendiğinde birkaç durum vardır:
Sınıf tanımını bölmek için kısmi anahtar sözcük değiştiricisini kullanın. Uygulamada, her kısmi sınıf genellikle ayrı bir dosyada tanımlanır ve bu da sınıfın zaman içinde yönetilmesini ve genişletilmesi kolaylaşır.
Aşağıdaki Employee örnekte sınıfın iki dosyaya nasıl bölünebileceği gösterilmektedir: Employee_Part1.cs ve Employee_Part2.cs.
// This is in Employee_Part1.cs
public partial class Employee
{
public void DoWork()
{
Console.WriteLine("Employee is working.");
}
}
// This is in Employee_Part2.cs
public partial class Employee
{
public void GoToLunch()
{
Console.WriteLine("Employee is at lunch.");
}
}
//Main program demonstrating the Employee class usage
public class Program
{
public static void Main()
{
Employee emp = new Employee();
emp.DoWork();
emp.GoToLunch();
}
}
// Expected Output:
// Employee is working.
// Employee is at lunch.
partial anahtar sözcüğü sınıfın, yapının veya arabirimin diğer bölümlerinin ad alanında tanımlanabileceğini gösterir. Tüm parçalar anahtar sözcüğünü partial kullanmalıdır. Son türü oluşturmak için derleme zamanında tüm bölümlerin kullanılabilir olması gerekir. Tüm bölümlerin , private, vb. gibi publicaynı erişilebilirliği olmalıdır.
Herhangi bir bölüm soyut olarak bildirilirse, türün tamamı soyut olarak kabul edilir. Herhangi bir parça mühürlenmiş olarak bildirilirse, tüm tip sızdırmaz olarak kabul edilir. Herhangi bir bölüm bir temel tür bildirirse, tüm tür bu sınıfı devralır.
Temel sınıfı belirten tüm bölümlerin kabul etmesi gerekir, ancak temel sınıfı atlayan bölümler yine de temel türü devralır. Parçalar farklı temel arabirimler belirtebilir ve son tür tüm kısmi bildirimler tarafından listelenen tüm arabirimleri uygular. Kısmi bir tanımda bildirilen tüm sınıf, yapı veya arabirim üyeleri diğer tüm bölümler tarafından kullanılabilir. Son tür, derleme zamanındaki tüm parçaların birleşimidir.
Not
partial Değiştirici, temsilci veya numaralandırma bildirimlerinde kullanılamaz.
Aşağıdaki örnek, iç içe yerleştirilmiş türlerin kısmi olmasa bile kısmi olabileceğini gösterir.
class Container
{
partial class Nested
{
void Test() { }
}
partial class Nested
{
void Test2() { }
}
}
Derleme zamanında, kısmi tür tanımların öznitelikleri birleştirilir. Örneğin, aşağıdaki bildirimleri göz önünde bulundurun:
[SerializableAttribute]
partial class Moon { }
[ObsoleteAttribute]
partial class Moon { }
Bunlar aşağıdaki bildirimlere eşdeğerdir:
[SerializableAttribute]
[ObsoleteAttribute]
class Moon { }
Aşağıdakiler tüm kısmi tür tanımlarından birleştirilir:
Örneğin, aşağıdaki bildirimleri göz önünde bulundurun:
partial class Earth : Planet, IRotate { }
partial class Earth : IRevolve { }
Bunlar aşağıdaki bildirimlere eşdeğerdir:
class Earth : Planet, IRotate, IRevolve { }
Kısmi sınıf tanımlarıyla çalışırken izleyebileceğiniz birkaç kural vardır:
partialdeğiştirilmelidir. Örneğin, aşağıdaki sınıf bildirimleri bir hata oluşturur:public partial class A { }
//public class A { } // Error, must also be marked partial
partial yalnızca , structveya interfaceanahtar sözcüğünden classhemen önce görünebilir.partial class ClassWithNestedClass
{
partial class NestedClass { }
}
partial class ClassWithNestedClass
{
partial class NestedClass { }
}
Daha fazla bilgi için bkz . Tür Parametrelerindeki Kısıtlamalar.
Aşağıdaki örnekte, sınıfın alanları ve oluşturucuları Coords bir kısmi sınıf tanımında ()Coords_Part1.cs bildirilir ve PrintCoords yöntem başka bir kısmi sınıf tanımında (Coords_Part2.cs) bildirilir. Bu ayrım, daha kolay bakım için kısmi sınıfların birden çok dosyaya nasıl bölünebileceğini gösterir.
// This is in Coords_Part1.cs
public partial class Coords
{
private int x;
private int y;
public Coords(int x, int y)
{
this.x = x;
this.y = y;
}
}
// This is in Coords_Part2.cs
public partial class Coords
{
public void PrintCoords()
{
Console.WriteLine("Coords: {0},{1}", x, y);
}
}
// Main program demonstrating the Coords class usage
class TestCoords
{
static void Main()
{
Coords myCoords = new Coords(10, 15);
myCoords.PrintCoords();
// Keep the console window open in debug mode.
Console.WriteLine("Press any key to exit.");
Console.ReadKey();
}
}
// Output: Coords: 10,15
Aşağıdaki örnekte kısmi yapılar ve arabirimler de geliştirebileceğiniz gösterilmektedir.
partial interface ITest
{
void Interface_Test();
}
partial interface ITest
{
void Interface_Test2();
}
partial struct S1
{
void Struct_Test() { }
}
partial struct S1
{
void Struct_Test2() { }
}
Kısmi bir sınıf veya yapı kısmi üye içerebilir. Sınıfının bir bölümü üyenin imzasını içerir. Bir uygulama aynı bölümde veya başka bir bölümde tanımlanabilir.
İmza aşağıdaki kurallara uyduğunda kısmi bir yöntem için bir uygulama gerekli değildir:
private .void.out sahip değil.yöntemi ve yöntemine yapılan tüm çağrılar, uygulama olmadığında derleme zamanında kaldırılır.
Özellikler ve dizin oluşturucular da dahil olmak üzere tüm bu kısıtlamalara uymayan tüm yöntemler bir uygulama sağlamalıdır. Bu uygulama bir kaynak oluşturucu tarafından sağlanabilir. Kısmi özellikler otomatik olarak uygulanan özellikler kullanılarak uygulanamaz. Derleyici, otomatik olarak uygulanan bir özellik ile kısmi özelliğin bildirim bildirimi arasında ayrım yapamaz.
C# 13'le başlayarak, kısmi bir özellik için uygulama bildirimi, uygulama bildirimini tanımlamak için alan destekli özellikleri kullanabilir. Alan destekli özellik, anahtar sözcüğün field özelliği için derleyici tarafından sentezlenen yedekleme alanına eriştiği kısa bir söz dizimi sağlar. Örneğin, aşağıdakileri yazabilirsiniz:
// in file1.cs
public partial class PropertyBag
{
// Defining declaration
public partial int MyProperty { get; set; }
}
// In file2.cs
public partial class PropertyBag
{
// Defining declaration
public partial int MyProperty { get => field; set; }
}
veya erişimcisinde get set veya her ikisinde de kullanabilirsinizfield.
Önemli
Anahtar field sözcük, C# 13'teki bir önizleme özelliğidir. Bağlamsal anahtar sözcüğü kullanmak için preview proje dosyanızda .NET 9 kullanıyor field olmanız ve öğenizi <LangVersion> olarak ayarlamanız gerekir.
adlı fieldbir alanı olan bir sınıfta anahtar sözcük özelliğini kullanırken field dikkatli olmalısınız. Yeni field anahtar sözcük, özellik erişimcisi kapsamında adlı field bir alanın gölgesini oluşturur. Değişkenin adını değiştirebilir veya tanımlayıcıya olarak başvurmak field için belirteci kullanabilirsiniz@.@fieldfield Anahtar sözcüğü için özellik belirtimini field okuyarak daha fazla bilgi edinebilirsiniz.
Kısmi yöntemler, sınıfın bir bölümünün uygulayıcısının üye bildirmesini sağlar. Sınıfın başka bir bölümünün uygulayıcısı bu üyeyi tanımlayabilir. Bu ayırmanın yararlı olduğu iki senaryo vardır: ortak kod oluşturan şablonlar ve kaynak oluşturucular.
// Definition in file1.cs
partial void OnNameChanged();
// Implementation in file2.cs
partial void OnNameChanged()
{
// method body
}
Daha fazla bilgi için bkz. C# Dil Belirtimi'nde Kısmi türler ve Kısmi yöntemler. Dil belirtimi, C# sözdizimi ve kullanımı için kesin bir kaynaktır. Kısmi yöntemler için yeni özellikler özellik belirtiminde tanımlanır.
.NET geri bildirimi
.NET, açık kaynak bir projedir. Geri bildirim sağlamak için bir bağlantı seçin:
Eğitim
Modül
Sınıf Uygulamalarını Yönetme - Training
Statik sınıflar, kısmi sınıflar ve kodunuzun okunabilirliğini, sürdürülebilirliğini ve düzenlemesini geliştirebilen nesne başlatıcılar gibi gelişmiş teknikleri kullanarak sınıfları uygulamayı öğrenin.
Belgeler
C# içindeki tüm türler ve tür üyeleri, diğer kodlardan kullanılıp kullanılamayacağını denetleen bir erişilebilirlik düzeyine sahiptir. Bu erişim değiştiricileri listesini gözden geçirin.
mühürlü değiştirici - C# reference
sealed modifier - C# Başvurusu
Statik Sınıflar ve Statik Sınıf Üyeleri - C#
Statik sınıflar C# dilinde örneği oluşturulamaz. Sınıf adının kendisini kullanarak statik sınıfın üyelerine erişebilirsiniz.
