Dela via


Slutpunkter: Adresser, bindningar och kontrakt

All kommunikation med en WCF-tjänst (Windows Communication Foundation) sker via tjänstens slutpunkter. Slutpunkter ger klienter åtkomst till de funktioner som erbjuds av en WCF-tjänst.

Varje slutpunkt består av fyra egenskaper:

  • En adress som anger var slutpunkten finns.

  • En bindning som anger hur en klient kan kommunicera med slutpunkten.

  • Ett kontrakt som identifierar de tillgängliga åtgärderna.

  • En uppsättning beteenden som anger lokal implementeringsinformation för slutpunkten.

I det här avsnittet beskrivs den här slutpunktsstrukturen och hur den representeras i WCF-objektmodellen.

Strukturen för en slutpunkt

Varje slutpunkt består av följande:

  • Adress: Adressen identifierar slutpunkten unikt och talar om för potentiella användare av tjänsten där den finns. Den representeras i WCF-objektmodellen av EndpointAddress klassen. En EndpointAddress klass innehåller:

    • En Uri egenskap som representerar tjänstens adress.

    • En Identity egenskap som representerar tjänstens säkerhetsidentitet och en samling valfria meddelandehuvuden. De valfria meddelandehuvudena används för att ge ytterligare och mer detaljerad adressinformation för att identifiera eller interagera med slutpunkten.

    Mer information finns i Ange en slutpunktsadress.

  • Bindning: Bindningen anger hur du kommunicerar med slutpunkten. Detta omfattar:

    • Transportprotokollet som ska användas (till exempel TCP eller HTTP).

    • Kodningen som ska användas för meddelandena (till exempel text eller binär).

    • Nödvändiga säkerhetskrav (till exempel SSL- eller SOAP-meddelandesäkerhet).

    Mer information finns i Översikt över WCF-bindningar. En bindning representeras i WCF-objektmodellen av den abstrakta basklassen Binding. I de flesta scenarier kan användarna använda en av bindningarna som tillhandahålls av systemet. Mer information finns i Bindningar som tillhandahålls av systemet.

  • Kontrakt: Kontraktet beskriver vilka funktioner slutpunkten exponerar för klienten. Ett kontrakt anger:

    • Vilka åtgärder kan anropas av en klient.

    • Meddelandets form.

    • Typ av indataparametrar eller data som krävs för att anropa åtgärden.

    • Vilken typ av bearbetnings- eller svarsmeddelande klienten kan förvänta sig.

    Mer information om hur du definierar ett kontrakt finns i Designa tjänstkontrakt.

  • Beteenden: Du kan använda slutpunktsbeteenden för att anpassa det lokala beteendet för tjänstslutpunkten. Slutpunktsbeteenden uppnår detta genom att delta i processen att skapa en WCF-körning. Ett exempel på ett slutpunktsbeteende är ListenUri egenskapen, som gör att du kan ange en annan lyssningsadress än SOAP- eller WSDL-adressen (Web Services Description Language). Mer information finns i ClientViaBehavior.

Definiera slutpunkter

Du kan ange slutpunkten för en tjänst antingen imperativt med hjälp av kod eller deklarativt via konfiguration. Mer information finns i Så här skapar du en tjänstslutpunkt i Konfiguration och Så här skapar du en tjänstslutpunkt i kod.

I det här avsnittet

I det här avsnittet förklaras syftet med bindningar, slutpunkter och adresser. visar hur du konfigurerar en bindning och en slutpunkt. och visar hur du ClientVia använder beteendet och ListenUri egenskapen.

Adresser
Beskriver hur slutpunkter hanteras i WCF.

Bindningar
Beskriver hur bindningar används för att ange den transport-, kodnings- och protokollinformation som krävs för att klienter och tjänster ska kunna kommunicera med varandra.

Kontrakt
Beskriver hur kontrakt definierar metoderna för en tjänst.

Anvisningar: Skapa en tjänstslutpunkt i konfigurationen
Beskriver hur du skapar en tjänstslutpunkt i konfigurationen.

Gör så här: Skapa en tjänstslutpunkt i kod
Beskriver hur du skapar en tjänstslutpunkt i kod.

Anvisningar: Använd Svcutil.exe för att verifiera kompilerad tjänstkod
Beskriver hur du identifierar fel i tjänstimplementeringar och konfigurationer utan att vara värd för tjänsten med hjälp av ServiceModel Metadata Utility Tool (Svcutil.exe).

Se även