Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase OutAttribute

 

Publicado: octubre de 2016

Indica que las referencias de los datos se deben calcular desde el destinatario de la llamada al llamador.

Espacio de nombres:   System.Runtime.InteropServices
Ensamblado:  mscorlib (en mscorlib.dll)

System.Object
  System.Attribute
    System.Runtime.InteropServices.OutAttribute

[AttributeUsageAttribute(AttributeTargets.Parameter, Inherited = false)]
[ComVisibleAttribute(true)]
public sealed class OutAttribute : Attribute

NombreDescripción
System_CAPS_pubmethodOutAttribute()

Inicializa una nueva instancia de la clase OutAttribute.

NombreDescripción
System_CAPS_pubpropertyTypeId

Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute.(Heredado de Attribute).

NombreDescripción
System_CAPS_pubmethodEquals(Object)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Devuelve un valor que indica si esta instancia equivale al objeto especificado. (Heredado de Attribute).

System_CAPS_pubmethodGetHashCode()

Devuelve el código hash de esta instancia.(Heredado de Attribute).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodIsDefaultAttribute()

Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada.(Heredado de Attribute).

System_CAPS_pubmethodMatch(Object)

Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual al objeto especificado. (Heredado de Attribute).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.(Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Obtiene la información del tipo de un objeto, que puede utilizarse para obtener la información del tipo de una interfaz. (Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfoCount(UInt32)

Recupera el número de interfaces de tipo de información que suministra un objeto (0 ó 1)

(Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Proporciona acceso a las propiedades y los métodos expuestos por un objeto.(Heredado de Attribute).

Este atributo se puede aplicar a parámetros.

El OutAttribute es opcional. El atributo se admite para interoperabilidad COM y solo la invocación de plataforma. En ausencia de valores explícitos, el contador de referencias de interoperabilidad supone reglas basan en el parámetro de tipo, si el parámetro se pasa por referencia o por valor y si el tipo es transferirse o espacio. Por ejemplo, el StringBuilder clase siempre se supone que la entrada/salida y se supone están en una matriz de cadenas que se pasan por valor.

Comportamiento solo nunca es un valor predeterminado el cálculo de referencias para los parámetros. Puede aplicar el OutAttribute tipos de valor y referencia pasados por referencia para cambiar la entrada/salida comportamiento al comportamiento de sólo Out, que equivale a usar la out palabra clave de C#. Por ejemplo, matrices que se pasan por valor, se calculan las referencias como parámetros sólo In de forma predeterminada, se pueden cambiar a sólo Out. Sin embargo, el comportamiento no siempre proporciona la semántica esperada cuando los tipos incluyen transferirse todos los elementos o campos porque el contador de referencias de interoperabilidad utiliza la fijación. Si no le importa pasar datos en el destinatario, el cálculo de referencias sólo Out puede proporcionar un mejor rendimiento para los tipos.

Combinar el InAttribute y OutAttribute es especialmente útil cuando se aplica a matrices y tipos, el formato. Los llamadores ven los cambios que realiza un destinatario de la llamada a estos tipos sólo cuando se aplican ambos atributos. Como estos tipos requieren copias durante el cálculo de referencias, se puede utilizar InAttribute y OutAttribute para reducir el número de copias innecesaria.

Para obtener más información sobre el efecto de OutAttribute en el cálculo de referencias, vea atributos direccionales.

En el ejemplo siguiente se muestra cómo aplicar el InAttribute y OutAttribute prototipo que pasa una matriz como parámetro de invocación de una plataforma. La combinación de atributos direccionales permite al llamador ver los cambios realizados por el destinatario.

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;
    // ...
}

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

public class MainMethod
{
    static void Main()
    { }

}

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: