ObjectParameter Konstruktory

Definicja

Przestrzeń nazw:

System.Data.Objects

Zestaw:

System.Data.Entity.dll

Inicjuje nowe wystąpienie klasy ObjectParameter.

Przeciążenia

ObjectParameter(String, Object)	Inicjuje ObjectParameter nowe wystąpienie klasy o określonej nazwie i wartości.
ObjectParameter(String, Type)	Inicjuje ObjectParameter nowe wystąpienie klasy o określonej nazwie i typie.

ObjectParameter(String, Object)

Inicjuje ObjectParameter nowe wystąpienie klasy o określonej nazwie i wartości.

public:
 ObjectParameter(System::String ^ name, System::Object ^ value);

public ObjectParameter (string name, object value);

new System.Data.Objects.ObjectParameter : string * obj -> System.Data.Objects.ObjectParameter

Public Sub New (name As String, value As Object)

Parametry

name

String

Nazwa parametru. Ta nazwa nie powinna zawierać znacznika parametru "@", który jest używany w instrukcjach Entity SQL, tylko rzeczywistą nazwę. Pierwszy znak wyrażenia musi być literą. Wszystkie kolejne znaki w wyrażeniu muszą być literami, cyframi lub znakiem podkreślenia (_).

value

Object

Wartość początkowa (i z natury typ) parametru.

Wyjątki

ArgumentNullException

Jeśli wartość dowolnego argumentu ma wartość null.

ArgumentOutOfRangeException

Jeśli wartość argumentu nazwy jest nieprawidłowa. Nazwy parametrów muszą zaczynać się literą i mogą zawierać tylko litery, cyfry i podkreślenia.

Przykłady

W tym przykładzie dodano nowe parametry do kolekcji. Iteruje przez ObjectParameterCollection i wyświetla nazwę, typ i wartość każdego parametru w kolekcji.

using (AdventureWorksEntities context =
    new AdventureWorksEntities())
{
    string queryString =
        @"SELECT VALUE contact FROM AdventureWorksEntities.Contacts
        AS contact WHERE contact.LastName = @ln
        AND contact.FirstName = @fn";

    ObjectQuery<Contact> contactQuery =
        new ObjectQuery<Contact>(queryString, context);

    // Add parameters to the collection.
    contactQuery.Parameters.Add(new ObjectParameter("ln", "Adams"));
    contactQuery.Parameters.Add(new ObjectParameter("fn", "Frances"));

    ObjectParameterCollection objectParameterCollection =
        contactQuery.Parameters;

    // Iterate through the ObjectParameterCollection.
    foreach (ObjectParameter result in objectParameterCollection)
    {
        Console.WriteLine("{0} {1} {2}", result.Name,
            result.Value,
            result.ParameterType);
    }
}

Uwagi

Ten konstruktor tworzy parametr z określonej nazwy i wartości. Typ parametru jest wnioskowany z wartości.

Po dodaniu do elementu nie można zmienić nazwy parametru ObjectParameterCollection. Wartość parametru Value można zmienić za pomocą właściwości. Po skompilowaniu zapytania nie można zmienić wartości. Aby uzyskać więcej informacji, zobacz Metody konstruktora zapytań.

Zobacz też

• Wykonywanie zapytań dotyczących danych jako obiektów i kształtowanie wyników (Entity Framework)

ObjectParameter(String, Type)

Inicjuje ObjectParameter nowe wystąpienie klasy o określonej nazwie i typie.

public:
 ObjectParameter(System::String ^ name, Type ^ type);

public ObjectParameter (string name, Type type);

new System.Data.Objects.ObjectParameter : string * Type -> System.Data.Objects.ObjectParameter

Public Sub New (name As String, type As Type)

Parametry

name

String

Nazwa parametru. Ta nazwa nie powinna zawierać znacznika parametru "@", który jest używany w instrukcjach Entity SQL, tylko rzeczywistą nazwę. Pierwszy znak wyrażenia musi być literą. Wszystkie kolejne znaki w wyrażeniu muszą być literami, cyframi lub znakiem podkreślenia (_).

type

Type

Typ środowiska uruchomieniowego języka wspólnego (CLR) parametru.

Wyjątki

ArgumentNullException

Jeśli wartość dowolnego argumentu ma wartość null.

ArgumentOutOfRangeException

Jeśli wartość argumentu nazwy jest nieprawidłowa. Nazwy parametrów muszą zaczynać się literą i mogą zawierać tylko litery, cyfry i podkreślenia.

Uwagi

Po utworzeniu wystąpienia nie można zmienić nazwy parametru. Wartość parametru Value można ustawić lub zmienić za pomocą właściwości. Po skompilowaniu zapytania nie można zmienić wartości. Aby uzyskać więcej informacji, zobacz Metody konstruktora zapytań.