Table of contents
TOC
Inhaltsverzeichnis reduzieren
Inhaltsverzeichnis erweitern

DoCmd.SendObject-Methode (Access)DoCmd.SendObject Method (Access)

office 365 dev account|Zuletzt aktualisiert: 30.01.2018
|
2 Mitarbeiter

Mit der SendObject-Methode wird die SendObject-Aktion in Visual Basic ausgeführt.The SendObject method carries out the SendObject action in Visual Basic.

SyntaxSyntax

expression.expression.SendObject(ObjectType, ObjectName, OutputFormat, To, Cc, Bcc, Subject, MessageText, EditMessage, TemplateFile)SendObject(ObjectType, ObjectName, OutputFormat, To, Cc, Bcc, Subject, MessageText, EditMessage, TemplateFile)

expression Eine Variable, die ein DoCmd-Objekt darstellt.expression A variable that represents a DoCmd object.

ParameterParameters

NameNameErforderlich/OptionalRequired/OptionalDatentypData TypeBeschreibungDescription
ObjectTypeObjectTypeOptionalOptionalAcSendObjectTypeAcSendObjectTypeEine AcSendObjectType -Konstante, die den Typ des zu sendenden Objekts angibt.A AcSendObjectType constant that specifies the type of object to send.
ObjectNameObjectNameOptionalOptionalVariantVariantEin Zeichenfolgenausdruck, der dem gültigen Namen eines Objekts des Typs entspricht, der vom Argument ObjectType ausgewählt wurde. Wenn Sie das aktive Objekt in eine E-Mail-Nachricht einschließen möchten, müssen Sie den Typ des Objekts mithilfe des Arguments ObjectType angeben; für dieses Argument geben Sie dann keinen Wert an. Wenn Sie für das Argument ObjectType als auch für das Argument ObjectName keinen Wert angeben, wird von Microsoft Access eine Nachricht an die E-Mail-Anwendung gesendet, ohne ein Datenbankobjekt in die Nachricht einzuschließen (in diesem Fall wird für das Argument ObjectType die acSendNoObject -Standardkonstante verwendet). Wenn Sie Visual Basic-Code, der die SendObject -Methode enthält, in einer Bibliotheksdatenbank ausführen, wird in Microsoft Access das Objekt mit diesem Namen zuerst in der Bibliotheksdatenbank und dann in der aktuellen Datenbank gesucht.A string expression that's the valid name of an object of the type selected by the ObjectType argument. If you want to include the active object in the mail message, specify the object's type with the ObjectType argument and leave this argument blank. If you leave both the ObjectType and ObjectName arguments blank (the default constant, acSendNoObject, is assumed for the ObjectType argument), Microsoft Access sends a message to the electronic mail application without an included database object. If you run Visual Basic code containing the SendObject method in a library database, Microsoft Access looks for the object with this name first in the library database, then in the current database.
OutputFormatOutputFormatOptionalOptionalVariantVariantEine Konstante, die das Format angibt, in dem das Objekt gesendet werden soll. Mögliche Werte sind acFormatHTML, acFormatRTF, acFormatSNP, acFormatTXT, acFormatXLS, acFormatXLSB, acFormatXLSX, acFormatXPS und acFormatPDF.A constant that specifies the format in which to send the object. Possible values include acFormatHTML, acFormatRTF, acFormatSNP, acFormatTXT, acFormatXLS, acFormatXLSB, acFormatXLSX, acFormatXPS, and acFormatPDF.
ToToOptionalOptionalVariantVariantEin Zeichenfolgenausdruck, der die Empfänger auflistet, deren Namen in der E-Mail-Nachricht in der Zeile „An“ stehen sollen.A string expression that lists the recipients whose names you want to put on the To line in the mail message.Trennen Sie die Namen der Empfänger, die Sie in diesem Argument (und in den Argumenten Cc und Bcc angeben, durch ein Semikolon (;) oder mit dem Listentrennzeichen, das in der Systemsteuerung von Windows im Dialogfeld Regionale Einstellungen auf der Registerkarte Zahl festgelegt ist.Separate the recipient names you specify in this argument and in the cc and bcc arguments with a semicolon (;) or with the list separator set on the Number tab of the Regional Settings Properties dialog box in Windows Control Panel.Wenn die Empfängernamen von der E-Mail-Anwendung nicht erkannt werden, wird die Nachricht nicht gesendet und ein Fehler tritt auf.If the recipient names aren't recognized by the mail application, the message isn't sent and an error occurs.Wenn Sie dieses Argument leer lassen, fragt Microsoft Access nach den Empfängern.If you leave this argument blank, Microsoft Access prompts you for the recipients.
CcCcOptionalOptionalVariantVariantEin Zeichenfolgenausdruck, der die Empfänger auflistet, deren Namen in die Cc-Zeile der E-Mail-Nachricht aufgenommen werden sollen. Wenn Sie für dieses Argument keinen Wert angeben, ist die Cc-Zeile der E-Mail-Nachricht leer.A string expression that lists the recipients whose names you want to put on the Cc line in the mail message. If you leave this argument blank, the Cc line in the mail message is blank.
BccBccOptionalOptionalVariantVariantEin Zeichenfolgenausdruck, der die Empfänger auflistet, deren Namen in die Bcc-Zeile der E-Mail-Nachricht aufgenommen werden sollen. Wenn Sie für dieses Argument keinen Wert angeben, ist die Bcc-Zeile der E-Mail-Nachricht leer.A string expression that lists the recipients whose names you want to put on the Bcc line in the mail message. If you leave this argument blank, the Bcc line in the mail message is blank.
SubjectSubjectOptionalOptionalVariantVariantEin Zeichenfolgenausdruck, der den Text enthält, der in die Zeile Betreff der E-Mail-Nachricht aufgenommen werden soll. Wenn Sie für dieses Argument keinen Wert angeben, ist die Zeile Betreff der E-Mail-Nachricht leer.A string expression containing the text you want to put on the Subject line in the mail message. If you leave this argument blank, the Subject line in the mail message is blank.
MessageTextMessageTextOptionalOptionalVariantVariantEin Zeichenfolgenausdruck, der den Text enthält, den Sie nach dem Objekt in den Nachrichtentext der E-Mail-Nachricht aufnehmen möchten. Wenn Sie für dieses Argument keinen Wert angeben, wird nur das Objekt, jedoch kein Text in die E-Mail-Nachricht eingeschlossen.A string expression containing the text you want to include in the body of the mail message, after the object. If you leave this argument blank, the object is all that's included in the body of the mail message.
EditMessageEditMessageOptionalOptionalVariantVariantVerwenden Sie True (-1), wenn die E-Mail-Anwendung sofort zusammen mit der geladenen Nachricht geöffnet werden soll, sodass die Nachricht bearbeitet werden kann. Verwenden Sie False (0), um die Nachricht ohne vorherige Bearbeitung zu senden. Wenn Sie für dieses Argument keinen Wert angeben, wird der Standardwert ( True ) verwendet.Use True (?1) to open the electronic mail application immediately with the message loaded, so the message can be edited. Use False (0) to send the message without editing it. If you leave this argument blank, the default ( True ) is assumed.
TemplateFileTemplateFileOptionalOptionalVariantVariantEin Zeichenfolgenausdruck, der den vollständigen Namen und Pfad der Datei angibt, die Sie als Vorlage für eine HTML-Datei verwenden möchten.A string expression that's the full name, including the path, of the file you want to use as a template for an HTML file.

BemerkungenRemarks

Sie können die SendObject-Aktion verwenden, um das angegebene Datenblatt, das angegebene Formular, den angegebenen Bericht oder das angegebene Modul in eine E-Mail-Nachricht einzuschließen, wo sie angezeigt und weitergeleitet werden kann. You can use the SendObject action to include the specified Microsoft Access datasheet, form, report, or module in an electronic mail message, where it can be viewed and forwarded.Sie können Objekte im Microsoft Excel 2000- (.xls), MS-DOS-Text- (.txt), Rich-Text- (.rtf) oder HTML-Format (.html) in Nachrichten von Microsoft Outlook, Microsoft Exchange oder einer anderen E-Mail-Anwendung einschließen, die von der MAPI (Mail Applications Programming Interface) verwendet wird.You can include objects in Microsoft Excel 2000 (.xls), MS-DOS text (.txt), rich-text (.rtf), or HTML (.html) format in messages for Microsoft Outlook, Microsoft Exchange, or another electronic mail application that uses the Mail Applications Programming Interface (MAPI).

Folgende Regeln gelten, wenn Sie die SendObject-Aktion verwenden, um ein Datenbankobjekt in eine E-Mail-Nachricht einzuschließen:The following rules apply when you use the SendObject action to include a database object in a mail message:

  • Sie können Tabellen-, Abfrage- und Formulardatenblätter senden. Im verwendeten Objekt sehen alle Felder im Datenblatt so aus wie in Access, mit Ausnahme der Felder, die OLE-Objekte enthalten. Die Spalten für diese Felder sind im Objekt eingeschlossen, die Felder sind jedoch leer.You can send table, query, and form datasheets. In the included object, all fields in the datasheet look as they do in Access, except fields containing OLE objects. The columns for these fields are included in the object, but the fields are blank.

  • Für ein Steuerelement, das an ein Ja/Nein-Feld (eine Umschaltfläche, eine Optionsschaltfläche oder ein Kontrollkästchen) gebunden ist, wird in der Ausgabedatei der Wert "–1" (Ja) oder "0" (Nein) angezeigt.For a control bound to a Yes/No field (a toggle button, option button, or check box), the output file displays the value ?1 (Yes) or 0 (No).

  • Für ein Textfeld, das an das Feld Hyperlink gebunden ist, wird in der Ausgabedatei der Hyperlink für alle Ausgabeformate mit Ausnahme von MS-DOS-Text angezeigt (in diesem Fall wird der Hyperlink nur als normaler Text angezeigt).For a text box bound to a Hyperlink field, the output file displays the hyperlink for all output formats except MS-DOS text (in this case, the hyperlink is just displayed as normal text).

  • Wenn Sie ein Formular in der Formularansicht senden, enthält das eingeschlossene Objekt immer die Datenblattansicht des Objekts.If you send a form in Form view, the included object always contains the form's Datasheet view.

  • Wenn Sie einen Bericht senden, sind die einzigen Steuerelemente, die im Objekt eingeschlossen sind, Textfelder (für XLS-Dateien) oder Textfelder und Beschriftungen (für RTF-, TXT- und HTML-Dateien). Alle anderen Steuerelemente werden ignoriert. Die Kopf- und Fußzeileninformationen sind ebenfalls nicht eingeschlossen. Die einzige Ausnahme hierzu ist: Wenn Sie einen Bericht im Excel-Format senden, ist im Objekt ein Textfeld in einer Gruppenfußzeile eingeschlossen, das einen Ausdruck mit der Sum-Funktion enthält. In einer Kopf- oder Fußzeile ist kein anderes Steuerelement (und keine andere Aggregatfunktion als Sum) im Objekt eingeschlossen.If you send a report, the only controls that are included in the object are text boxes (for .xls files), or text boxes and labels (for .rtf, .txt, and .html files). All other controls are ignored. Header and footer information is also not included. The only exception to this is that when you send a report in Excel format, a text box in a group footer containing an expression with the Sum function is included in the object. No other control in a header or footer (and no aggregate function other than Sum) is included in the object.

  • Unterberichte sind im Objekt eingeschlossen. Unterformulare sind eingeschlossen, wenn eine Ausgabe in ASP erfolgt, aber nur bei Ausgabe als Formular (nicht als Datenblatt).Subreports are included in the object. Subforms are included when outputting to .asp, but only when outputting as a form (not a datasheet).

  • Wenn Sie ein Datenblatt, ein Formular oder eine Datenzugriffsseite im HTML-Format senden, wird eine HTML-Datei erstellt. Wenn Sie einen Bericht im HTML-Format senden, wird für jede Seite im Bericht eine HTML-Datei erstellt.When you send a datasheet, form, or data access page in HTML format, one .html file is created. When you send a report in HTML format, one .html file is created for each page in the report.

Module können nur im MS-DOS-Textformat ausgegeben werden. Wenn Sie also für das Argument ObjectType den Wert acSendModule angeben, müssen Sie für das Argument OutputFormat den Wert acFormatTXT angeben.Modules can be sent only in MS-DOS Text format, so if you specify acSendModule for the ObjectType argument, you must specify acFormatTXT for the OutputFormat argument.

Hinweis

Sie können in einem 2007 Microsoft Office System-Programm nur als PDF- oder XPS-Datei speichern, nachdem Sie ein Add-In installiert haben. Suchen Sie auf der Office-Website nach "Aktivieren der Unterstützung für andere Dateiformate wie PDF und XPS", um weitere Informationen zu finden.You can save as a PDF or XPS file from a 2007 Microsoft Office system program only after you install an add-in. For more information, search for "Enable support for other file formats, such as PDF and XPS" on the Office Web site.

Der Link stammt von:Symbol für Communitymitglied Luke Chung, FMS, Inc.Link provided by:Community Member Icon Luke Chung, FMS, Inc.

Der Link stammt von:Symbol für Communitymitglied The UtterAccess CommunityLink provided by:Community Member Icon The UtterAccess community

BeispielExample

Dieser Beispielcode nimmt die Employees-Tabelle im Microsoft Excel-Format in eine E-Mail-Nachricht auf und gibt die Zeilen An, Cc und Betreff der Nachricht an.The following code example includes the Employees table in a mail message in Microsoft Excel format and specifies To, Cc, and Subject lines in the mail message.Die Nachricht wird sofort ohne vorherige Bearbeitung gesendet.The mail message is sent immediately, without editing.

DoCmd.SendObject acSendTable, "Employees", acFormatXLS, _ 
    "Nancy Davolio; Andrew Fuller", "Joan Weber", , _ 
    "Current Spreadsheet of Employees", , False

Im folgenden Beispiel wird gezeigt, wie eine E-Mail mit Microsoft Outlook erstellt und dem Benutzer angezeigt wird.The following example shows how to create an email message with Microsoft Outlook and display it to the user.

Der Beispielcode stammt von: **Microsoft Access 2010 Programmer's ReferenceSample code provided by:** The Microsoft Access 2010 Programmer's Reference

Public Function CreateEmailWithOutlook( _
    MessageTo As String, _
    Subject As String, _
    MessageBody As String)

    ' Define app variable and get Outlook using the "New" keyword
    Dim olApp As New Outlook.Application
    Dim olMailItem As Outlook.MailItem  ' An Outlook Mail item

    ' Create a new email object
    Set olMailItem = olApp.CreateItem(olMailItem)

    ' Add the To/Subject/Body to the message and display the message
    With olMailItem
        .To = MessageTo
        .Subject = Subject
        .Body = MessageBody
        .Display    ' To show the email message to the user
    End With

    ' Release all object variables
    Set olMailItem = Nothing
    Set olApp = Nothing

End Function

Im folgenden Beispiel wird gezeigt, wie eine E-Mail mit Microsoft Outlook erstellt und gesendet wird, ohne dass die E-Mail dem Benutzer angezeigt wird.The following example shows how to create an email message with Microsoft Outlook and send it without displaying the email message to the user.

Public Function SendEmailWithOutlook( _
    MessageTo As String, _
    Subject As String, _
    MessageBody As String)

    ' Define app variable and get Outlook using the "New" keyword
    Dim olApp As New Outlook.Application
    Dim olMailItem As Outlook.MailItem  ' An Outlook Mail item

    ' Create a new email object
    Set olMailItem = olApp.CreateItem(olMailItem)

    ' Add the To/Subject/Body to the message and display the message
    With olMailItem
        .To = MessageTo
        .Subject = Subject
        .Body = MessageBody
        .Send       ' Send the message immediately
    End With

    ' Release all object variables
    Set olMailItem = Nothing
    Set olApp = Nothing

End Function

Informationen zu den MitwirkendenAbout the contributors

Luke Chung ist Gründer und President von FMS, Inc., einem führenden Anbieter benutzerdefinierter Datenbanklösungen und Entwicklertools.Luke Chung is the founder and president of FMS, Inc., a leading provider of custom database solutions and developer tools.

Wrox Press wird getragen von der Philosophie "von Programmierern für Programmierer". Wrox-Bücher wurden von Programmierern für Programmierer verfasst, und die Marke Wrox steht für intelligente Lösungen für praktische Programmierprobleme.Wrox Press is driven by the Programmer to Programmer philosophy. Wrox books are written by programmers for programmers, and the Wrox brand means authoritative solutions to real-world programming problems.

UtterAccess ist das führende Microsoft Access-Wiki und -Hilfeforum. Zum Beitreten hier klicken.UtterAccess is the premier Microsoft Access wiki and help forum. Click here to join.

Siehe auchSee also

DoCmd-ObjektDoCmd Object

© 2018 Microsoft