OutAttribute Sınıf

Tanım

public ref class OutAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Parameter, Inherited=false)]
public sealed class OutAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Parameter, Inherited=false)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class OutAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Parameter, Inherited=false)>]
type OutAttribute = class
    inherit Attribute

[<System.AttributeUsage(System.AttributeTargets.Parameter, Inherited=false)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type OutAttribute = class
    inherit Attribute

Public NotInheritable Class OutAttribute
Inherits Attribute

Devralma

Object

Attribute

OutAttribute

Öznitelikler

AttributeUsageAttribute ComVisibleAttribute

Örnekler

Aşağıdaki örnek, bir diziyi InAttribute parametre olarak geçiren bir platform çağırma prototipine ve'nin OutAttribute nasıl uygulanacağını gösterir. Yönlü özniteliklerin birleşimi, çağıranın çağrıyı yapan tarafından yapılan değişiklikleri görmesine olanak tanır.

using namespace System;
using namespace System::Runtime::InteropServices;

// Declare a class member for each structure element.

[StructLayout(LayoutKind::Sequential, CharSet = CharSet::Unicode)]
public ref class OpenFileName
{
public:
    int structSize;
    String^ filter;
    String^ file;
    // ...
};

private ref class NativeMethods
{
public:

    // Declare a managed prototype for the unmanaged function.

    [DllImport("Comdlg32.dll", CharSet = CharSet::Unicode)]
    static bool GetOpenFileName([In, Out]OpenFileName^ ofn);
};

void main() {}

using System.Runtime.InteropServices;
using System;

// Declare a class member for each structure element.
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public class OpenFileName
{
    public int structSize = 0;
    public string filter = null;
    public string file = null;
    // ...
}

internal static class NativeMethods
{
    // Declare a managed prototype for the unmanaged function.
    [DllImport("Comdlg32.dll", CharSet = CharSet.Unicode)]
    internal static extern bool GetOpenFileName([In, Out] OpenFileName ofn);
}

public class MainMethod
{
    static void Main()
    { }
}

Imports System.Runtime.InteropServices

' Declare a class member for each structure element.
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Class OpenFileName

    Public structSize As Integer = 0
    Public filter As String = Nothing
    Public file As String = Nothing
    ' ...

End Class

Friend Class NativeMethods
    ' Declare managed prototype for the unmanaged function.
    Friend Declare Unicode Function GetOpenFileName Lib "Comdlg32.dll" (
       <[In](), Out()> ByVal ofn As OpenFileName) As Boolean
End Class

Public Class App
    Public Shared Sub Main()

    End Sub
End Class

Açıklamalar

Bu özniteliği parametrelere uygulayabilirsiniz.

OutAttribute isteğe bağlıdır. özniteliği yalnızca COM birlikte çalışma ve platform çağırma için desteklenir. Açık ayarların olmaması halinde birlikte çalışma sıralayıcısı parametre türüne, parametrenin başvuru veya değere göre geçirilip geçirilmediğine ve türün blittable veya blittable olmayan olmasına göre kuralları varsayar. Örneğin, sınıfın StringBuilder her zaman In/Out olduğu varsayılır ve değer tarafından geçirilen dize dizisinin In olduğu varsayılır.

Yalnızca dışarıda davranışı hiçbir zaman parametreler için varsayılan bir hazırlama davranışı değildir. C# dilinde anahtar sözcüğünü OutAttribute kullanmaya eşdeğer olan In/Out davranışını Yalnızca dışarı davranışı olarak değiştirmek için başvuru tarafından geçirilen değere ve başvuru türlerine out uygulayabilirsiniz. Örneğin, varsayılan olarak Yalnızca içi parametreler olarak sıralanmış değere göre geçirilen diziler Yalnızca Dışı olarak değiştirilebilir. Ancak, birlikte çalışma sıralayıcısı sabitleme kullandığından, türler tüm ayrılabilir öğeleri veya alanları içerdiğinde davranış her zaman beklenen semantiği sağlamaz. Çağırana veri geçirmeyi önemserseniz, Yalnızca giden sıralama, bölünebilir olmayan türler için daha iyi performans sağlayabilir.

dizilere InAttribute ve biçimlendirilmiş, bölünebilir olmayan türlere uygulandığında ve OutAttribute birleştirildiğinde özellikle yararlıdır. Arayanlar, çağıranın bu türlerde yaptığı değişiklikleri yalnızca her iki özniteliği de uyguladığınızda görür. Bu türler hazırlama sırasında kopyalama gerektirdiğinden, gereksiz kopyaları azaltmak için ve OutAttribute kullanabilirsinizInAttribute.

Hazırlama davranışı üzerindeki etkisi OutAttribute hakkında daha fazla bilgi için bkz . Yön Öznitelikleri.

Oluşturucular

Özellikler

Yöntemler

Belirtik Arabirim Kullanımları

Şunlara uygulanır

Ayrıca bkz.

• InAttribute
• StringBuilder
• Blok Halinde Kopyalanabilir ve Kopyalanamaz Türler