Gennemgang: Opbygge et konsolprogram, som opretter forbindelse til Microsoft Dynamics CRM 2015 ved hjælp af udviklerudvidelser

Artikel
07/06/2017

Udgivet: november 2016

Gælder for: Dynamics CRM 2015

I denne gennemgang demonstreres det, hvordan du skriver et enkelt konsolprogram, som opretter forbindelse til Microsoft Dynamics CRM 2015 ved hjælp af udviklerudvidelser og opretter en kontaktpost.

Du kan finde den eksempelkode, som denne gennemgang producerer, i mappen Walkthroughs\Portal\ConsoleAppWalkthrough.

Dette emne indeholder

Generer tidligt bundne typer

Opret et nyt konsolprogramprojekt i Visual Studio

Generer tidligt bundne typer

Kør værktøjet CrmSvcUtil.exe med udvidelsen "Microsoft.Xrm.Client.CodeGeneration" for at generere dine objektklasser og servicekontekster. Følgende er en eksempelkommando for at oprette en fil kaldet Xrm.cs, som peger på en forekomst af Microsoft Dynamics 365. Bemærk, at filen Microsoft.Xrm.Client.CodeGeneration.dll skal være i den samme mappe som filen CrmSvcUtil.exe eller i den systemglobale assemblycache, når du kører denne kommando. Den første viste kommando er for en lokal organisation. Den anden kommand er for en CRM Online-organisation. Begge kommandoer skal udføres som en enkelt kommandolinje uden linjeskift.
```
CrmSvcUtil.exe
/codeCustomization:"Microsoft.Xrm.Client.CodeGeneration.CodeCustomization, Microsoft.Xrm.Client.CodeGeneration"/out:Xrm.cs /url:http://<myserver>/<myorg>/XRMServices/2011/Organization.svc 
/domain:<mydomain> /username:<myusername> /password:<mypassword> /namespace:Xrm /serviceContextName:XrmServiceContext

CrmSvcUtil.exe
/codeCustomization:"Microsoft.Xrm.Client.CodeGeneration.CodeCustomization, Microsoft.Xrm.Client.CodeGeneration"
/out:Xrm.cs /url:https://<mydomain>.api.crm.dynamics.com/XRMServices/2011/Organization.svc
/username:<myusername>@<mydomain>.onmicrosoft.com /password:<mypassword> /namespace:Xrm /serviceContextName:XrmServiceContext
```
Tip

Værktøjet CrmSvcUtil er tilgængeligt i mappen Bin i SDK-downloadet eller ved at installere pakken Microsoft.CrmSdk.CoreToolsNuGet.

Opret et nyt konsolprogramprojekt i Visual Studio

Opret et nyt konsolprogram med navnet "ConsoleAppWalkthrough". Hvis du ikke allerede har .NET Framework 4.5.2 installeret, kan få udviklerpakken fra Installing the .NET Framework.
Tilføj de følgende referencer fra mappen SDK\bin. Du kan springe dette trin og det næste over ved blot at installere pakken Microsoft.CrmSdk.ExtensionsNuGet.
- AntiXSSLibrary.dll
- Microsoft.Crm.Sdk.Proxy.dll
- Microsoft.Xrm.Client.dll
- Microsoft.Xrm.Portal.dll
- Microsoft.Xrm.Portal.Files.dll
- Microsoft.Xrm.Sdk.dll
Tilføj de følgende referencer fra .NET.
- System.IdentityModel.dll
- Microsoft.ServiceBus.dll
- System.Data.Services.dll
- System.Data.Services.Client.dll
- System.Runtime.Serialization.dll
Sørg for, at konsolprojektet angiver .NET Framework 4.5.2 som destinationsstruktur og ikke .NET Framework 4.5.2-klientprofilen. Kontrollér egenskaberne for projektet ved at vælge projektet ConsoleAppWalkthrough i Solution Explorer og klikke på Alt-Enter.
Højreklik på projektet i Visual Studio, klik på Tilføj, og klik derefter på Eksisterende element.
Vælg filen "xrm.cs", som du oprettede, da du oprettede de tidligt bundne typer.
Højreklik på projektet igen, klik på Tilføj, og klik på Nyt element.
Vælg Programkonfigurationsfil fra indstillingerne, og klik derefter på Tilføj.

Rediger App.config-konfigurationsfilen med din specifikke forbindelsesstreng.

<?xml version="1.0"?>
<configuration>
  <configSections>
    <section name="microsoft.xrm.client" type="Microsoft.Xrm.Client.Configuration.CrmSection, Microsoft.Xrm.Client"/>
  </configSections>
  <connectionStrings>   <add name="Xrm" connectionString="Server=http://crmserver/contoso; Domain=CONTOSO; Username=Administrator;Password=pass@word1"/></connectionStrings>
  <microsoft.xrm.client>
    <contexts default="Xrm">
      <add name="Xrm" type="Xrm.XrmServiceContext, Xrm" connectionStringName="Xrm"/>
    </contexts>
  </microsoft.xrm.client>
  <startup>
    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5.2"/>
  </startup>
</configuration>

Tilføj en brugersætning til det navneområde, som du brugte i trin 1, da du oprettede projektet (for dette eksempel "Xrm").

Tilføj den følgende kode til din programklasse:

static void Main(string[] args)
{
    var xrm = new XrmServiceContext("Xrm");

    WriteExampleContacts(xrm);

    //Create a new contact called Allison Brown.
    var allisonBrown = new Xrm.Contact
    {
        FirstName = "Allison",
        LastName = "Brown",
        Address1_Line1 = "23 Market St.",
        Address1_City = "Sammamish",
        Address1_StateOrProvince = "MT",
        Address1_PostalCode = "99999",
        Telephone1 = "12345678",
        EMailAddress1 = "allison.brown@example.com"
    };

    xrm.AddObject(allisonBrown);
    xrm.SaveChanges();

    WriteExampleContacts(xrm);

    Console.WriteLine("Press any key to exit.");
    Console.ReadKey();
}

/// <summary>
/// Use all contacts where the email address ends in @example.com.
/// </summary>
private static void WriteExampleContacts(XrmServiceContext xrm)
{
    var exampleContacts = xrm.ContactSet
        .Where(c => c.EMailAddress1.EndsWith("@example.com"));

    //Write the example contacts.
    foreach (var contact in exampleContacts)
    {
        Console.WriteLine(contact.FullName);
    }
}

Udfør fejlfinding og test af løsningen. Derved oprettes en kontakt i din Dynamics 365-organisation.

Se også

Vejledning til portaludvikling til Microsoft Dynamics CRM 2015
Portalgennemgange til Dynamics CRM 2015
Gennemgang: Opbygge et webprogram, som opretter forbindelse til Microsoft Dynamics CRM 2015 ved hjælp af udviklerudvidelser

Del via

Gennemgang: Opbygge et konsolprogram, som opretter forbindelse til Microsoft Dynamics CRM 2015 ved hjælp af udviklerudvidelser

Dette emne indeholder

Generer tidligt bundne typer

Opret et nyt konsolprogramprojekt i Visual Studio

Se også

Yderligere ressourcer