Annotation Research Tool – Anwendungscode (EDM-Beispielanwendung)
Die Entitätsdatenmodell(EDM)-Anwendung Annotation Research Tool wird mit einem Windows Form und Steuerelementen aus der Visual Studio-Toolbox implementiert.
Ein WebBrowser-Steuerelement wird zum Anzeigen von Webverweisen verwendet. In verschiedenen Textfeldern können Benutzer Informationen eingeben, die als Anmerkungen und Kontaktinformationen verwendet werden. Die der Locator-Eigenschaft von Reference-Instanzen zugewiesenen URL-Zeichenfolgen werden aus dem Dokumentobjekt der im WebBrowser angezeigten Seite abgerufen, wenn Instanzen der ReferenceDescriptor-Klasse erstellt werden. Alle Benutzereingaben werden durch Ereignishandler verarbeitet. Eine Darstellung der Benutzeroberfläche finden Sie unter Annotation and Research Collaboration Tool (EDM-Beispielanwendung).
Datei exe.config und Verbindungszeichenfolge
Die folgende exe.config-Datei enthält die Verbindungszeichenfolge und Konfigurationsinformationen für eine SQL Server- oder SQL Server Compact 3.5-Datenbank. Auf den System.Data.EntityClient-Namespace, der von Verbindung und Metadaten verwendete Klassen enthält, wird ebenfalls verwiesen.
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<connectionStrings>
<add name="ResearchCollaborationData"
connectionString="metadata=.;
provider=System.Data.SqlClient;
provider connection string='server=servername;
database=ResearchCollaborationData;
integrated security=true;
multipleactiveresultsets=true'"
providerName="System.Data.EntityClient"/>
</connectionStrings>
</configuration>
.gif) Hinweis |
|---|
Diese Verbindungszeichenfolge legt "Multiple Active Result Sets" auf |
Initialisieren der Verbindung zum Speicher
Mit der vorherigen Datei exe.config im Gültigkeitsbereich der ausführbaren Datei und einem Verweis auf System.Data.Entity.dll im Projekt genügt eine einzige Codezeile, um eine Verbindung zu von dieser Anwendung verwendeten Daten zu öffnen.
ResearchCollaborationData researchCollaborationData =
new ResearchCollaborationData();
Alle Ereignishandler, die zum Abfragen oder Aktualisieren von Daten von dieser Anwendung genutzt werden, verwenden diese Initialisierung. Die Verbindung wird mit der folgenden Anweisung geschlossen:
researchCollaborationData.Connection.Close();
Erstellen eines Verweisdeskriptors
Mit dem folgenden Code wird eine Instanz der ReferenceDescriptor-Klasse erstellt und in den Speicher geschrieben. Die Sequenz ermittelt, ob die Seite im WebBrowser-Fenster bereits als Reference-Objekt vorhanden ist. Ist dies nicht der Fall, wird eine neue Instanz von Reference mit dem ReferenceDescriptor erstellt. Wenn sich Reference noch nicht im Speicher befindet, wird dieser durch einen Aufruf von AddToReference hinzugefügt: researchCollaborationData.AddToReferecne(newReference). Der ReferenceDescriptor wird dem Speicher mit einem Aufruf von researchCollaborationData.AddToReferenceDescriptor(newReferenceDescriptor) hinzugefügt.
Außerdem wird der ReferenceDescriptor der Auflistung hinzugefügt, die durch die Navigationseigenschaft der Reference mit dem Namen RefDescriptors dargestellt wird: newReference.RefDescriptors.Add(newReferenceDescriptor). newReference.RefDescriptors.Add(newReferenceDescriptor).
Die Anwendung implementiert keine Methode zum Erstellen einer Reference-Instanz ohne einen zugehörigen ReferenceDescriptor.
private void buttonCreateRefDescriptor_Click(
object sender, EventArgs e)
{
ResearchCollaborationData researchCollaborationData = null;
try
{
using (researchCollaborationData =
new ResearchCollaborationData())
{
ObjectParameter param = new ObjectParameter(
"p", webBrowser1.Document.Url.ToString());
if (!researchCollaborationData.Reference.Where(
"it.Locator = @p", param).Any())
{
Reference newReference = new Reference();
newReference.ReferenceID = Guid.NewGuid();
newReference.Locator = webBrowser1.Document.Url.ToString();
researchCollaborationData.AddToReference(newReference);
ReferenceDescriptor newReferenceDescriptor =
new ReferenceDescriptor();
newReferenceDescriptor.DescriptorID = Guid.NewGuid();
newReferenceDescriptor.Keyword =
textBoxKeyWord.Text;
newReferenceDescriptor.Annotation =
textBoxAnnotationResults.Text;
researchCollaborationData.AddToReferenceDescriptor(newReferenceDescriptor);
newReference.RefDescriptors.Add(
newReferenceDescriptor);
}
else
{
Reference reference =
researchCollaborationData.Reference.Where(
"it.Locator = @p", param).First();
ReferenceDescriptor newReferenceDescriptor =
new ReferenceDescriptor();
newReferenceDescriptor.DescriptorID = Guid.NewGuid();
newReferenceDescriptor.Keyword =
textBoxKeyWord.Text;
newReferenceDescriptor.Annotation =
textBoxAnnotationResults.Text;
researchCollaborationData.AddToReferenceDescriptor(newReferenceDescriptor);
reference.RefDescriptors.Add(
newReferenceDescriptor);
}
researchCollaborationData.SaveChanges();
researchCollaborationData.Connection.Close();
}
}
catch(Exception exception)
{
MessageBox.Show(exception.ToString());
researchCollaborationData.Connection.Close();
}
}
Erstellen einer ContactPerson-Instanz
Die Vorgehensweise beim Erstellen einer neuen ContactPerson-Instanz, die einer Reference zugeordnet wird, ist identisch mit dem Erstellen eines ReferenceDescriptor, der einer Reference zugeordnet wird. Es gibt vier mögliche Codeoptionen, je nachdem, ob ContactPerson und Reference bereits vorhanden sind. Im ersteren Fall der Erstellung eines ReferenceDescriptor wird stets eine neue Deskriptorinstanz erstellt. Durch den Vorgang der Zuordnung einer ContactPerson zu einer Reference wird ermittelt, ob eine Instanz von ContactPerson diesen Kontakt bereits darstellt.
Ein ReferenceDescriptor wird nur einer Reference zugeordnet, während eine ContactPerson mehreren References zugeordnet werden kann. Weitere Informationen über die Implementierung der m:n-Association, die diese Beziehung unterstützt, finden Sie unter Annotation Research Tool-Schemas (EDM-Beispielanwendung).
Die vier Codepfade im folgenden Ereignishandler verbinden jeweils Instanzen der ContactPerson-Entität mit Instanzen der Reference-Entität. Bei der ersten Option wird sowohl eine neue ContactPerson als auch eine neue Reference erstellt. Die neue ContactPerson und der neue Reference werden dem Speicher mit AddToContactPerson und AddToReference hinzugefügt. Da es sich hierbei um eine m:n-Zuordnung handelt, muss auch eine neue Verknüpfungsentität instanziiert werden, deren Navigationseigenschaften für das Verbinden der Instanzen von ContactPerson und Reference initialisiert werden.
ContactPersonReference newLink =
new ContactPersonReference();
newLink.ContactPersonRefID = Guid.NewGuid();
newLink.RelatedContact = newContact;
newLink.RelatedReference = newReference;
Diese Codesequenz instanziiert die Verknüpfungsentität mit dem Namen ContactPersonReference. Die Verknüpfungsentität verfügt über Navigationseigenschaften, die die beiden Enden der Zuordnung darstellen: RelatedContact und RelatedReference. Diesen werden die neuen Instanzen von ContactPerson und Reference zugewiesen, die in diesem Codepfad erstellt wurden. In anderen Fällen, in denen ContactPerson oder Reference oder beide bereits vorhanden sind, verwenden die Zuweisungen bestehende Instanzen, die durch Objektabfragen gefunden wurden.
Die neue Verknüpfungsentität wird dem Speicher hinzugefügt, und alle neuen Entitätsinstanzen werden mit dem folgenden Code gespeichert.
researchCollaborationData.AddToContactPersonReference(newLink);
researchCollaborationData.SaveChanges();
Zwei der vier möglichen Codepfade werden in der folgenden Sequenz gezeigt. Den vollständigen Ereignishandler finden Sie in der Methode private void buttonCreateRefPerson_Click(object sender, EventArgs e) im vollständigen Ereignishandlercode am Ende dieses Themas.
ObjectParameter paramContact =
new ObjectParameter("p", textBoxEmail.Text);
if (!researchCollaborationData.ContactPerson.Where(
"it.Email = @p", paramContact).Any())
{
ObjectParameter paramReference =
new ObjectParameter("p",
webBrowser1.Document.Url.ToString());
if (!researchCollaborationData.Reference.Where(
"it.Locator = @p", paramReference).Any())
{
// Neither contact nor reference exist.
ContactPerson newContact = new ContactPerson();
newContact.ContactPersonID = Guid.NewGuid();
newContact.LastName = textBoxLastName.Text;
newContact.FirstName = textBoxFirstName.Text;
newContact.Email = textBoxEmail.Text;
newContact.Title =
textBoxTitlePosition.Text;
researchCollaborationData.AddToContactPerson(newContact);
Reference newReference = new Reference();
newReference.ReferenceID = Guid.NewGuid();
newReference.Locator = webBrowser1.Document.Url.ToString();
researchCollaborationData.AddToReference(newReference);
ContactPersonReference newLink =
new ContactPersonReference();
newLink.ContactPersonRefID = Guid.NewGuid();
newLink.RelatedContact = newContact;
newLink.RelatedReference = newReference;
researchCollaborationData.AddToContactPersonReference(newLink);
}
else
{
// Reference exists but contact doesn't.
Reference reference =
researchCollaborationData.Reference.
Where("it.Locator = @p",
paramReference).First();
ContactPerson newContact = new ContactPerson();
newContact.ContactPersonID = Guid.NewGuid();
newContact.LastName = textBoxLastName.Text;
newContact.FirstName = textBoxFirstName.Text;
newContact.Email = textBoxEmail.Text;
newContact.Title =
textBoxTitlePosition.Text;
researchCollaborationData.AddToContactPerson(newContact);
ContactPersonReference newLink = new ContactPersonReference();
newLink.ContactPersonRefID = Guid.NewGuid();
newLink.RelatedContact = newContact;
newLink.RelatedReference = reference;
researchCollaborationData.AddToContactPersonReference(newLink);
}
}
Verwenden von Verweisdeskriptoren zum Suchen nach Verweisen
Instanzen der ReferenceDescriptor-Entität sind Anmerkungen, mit denen Webressourcen beschrieben und lokalisiert werden, sodass die Suche nicht noch einmal an anderer Stelle wiederholt oder katalogisiert werden muss. Jeder ReferenceDescriptor stellt eine einzelne Anmerkung dar. Viele Instanzen von ReferenceDescriptor können eine Webseite beschreiben, jede Instanz kann jedoch nur einer Seite zugeordnet sein.
Webverweise werden durch Hinzufügen von ReferenceDescriptor-Instanzen mit Anmerkungen versehen, wie in den vorherigen Codesegmenten beschrieben wird. Die Suche nach der Annotation-Eigenschaft und der Keyword-Eigenschaft von ReferenceDescriptor-Instanzen stellt ein Mittel zum erneuten Finden nützlicher Reference-Seiten dar. Der folgende Ereignishandler wird aufgerufen, wenn der Benutzer Schlüsselwörter oder einen Suchausdruck in das Textfeld eingibt und auf die Schaltfläche Find klickt.
private void buttonSearch_Click(object sender, EventArgs e)
{
ResearchCollaborationData researchCollaborationData = null;
try
{
using (researchCollaborationData =
new ResearchCollaborationData())
{
// Make a list of keywords to search for in annotatations.
List<string> keywords = new List<string>();
int i = 0;
int j = 0;
while (i < textBoxSearch.Text.Length)
{
j = textBoxSearch.Text.IndexOf(" ", i);
if (-1 == j) j = textBoxSearch.Text.Length;
keywords.Add(
textBoxSearch.Text.Substring(i, j - i));
i = ++j;
}
textBoxAnnotationResults.Text = "Results:";
foreach (string keyword in keywords)
{
// Create ObjectParameter from each keyword.
ObjectParameter paramKeyword =
new ObjectParameter(
"p", "%" + keyword + "%");
ObjectQuery<ReferenceDescriptor>
descriptorQuery =
researchCollaborationData.
ReferenceDescriptor.Where(
"it.Annotation LIKE @p OR it.Keyword LIKE @p",
paramKeyword);
foreach (ReferenceDescriptor refDescriptor
in descriptorQuery)
{
textBoxAnnotationResults.Text =
textBoxAnnotationResults.Text + "\n" +
refDescriptor.Keyword + "\n" +
refDescriptor.Annotation;
refDescriptor.ReferenceReference.Load();
Reference reference = refDescriptor.Reference;
textBoxAnnotationResults.Text =
textBoxAnnotationResults.Text + "\n" +
reference.Locator + "\n";
foreach (ContactPersonReference contactPersRef in
researchCollaborationData.ContactPersonReference)
{
contactPersRef.RelatedReferenceReference.Load();
if (contactPersRef.RelatedReferenceReference.Value.Equals(
reference))
{
contactPersRef.RelatedContactReference.Load();
textBoxAnnotationResults.Text =
textBoxAnnotationResults.Text +
"\n" +
"Relevant Contact:";
textBoxAnnotationResults.Text =
textBoxAnnotationResults.Text +
"\n" +
contactPersRef.
RelatedContact.FirstName + " " +
contactPersRef.RelatedContact.
LastName +
" Title: " + contactPersRef.
RelatedContact.Title + " Email: "
+ contactPersRef.RelatedContact.
Email
+ "\n";
}
}
}
}
}
}
catch (Exception exception)
{
MessageBox.Show(exception.ToString());
}
}
Dieser Code besteht aus zwei grundlegenden Sequenzen: eine zum Erstellen einer List<T> mit Suchzeichenfolgen und eine andere zum Abfragen nach übereinstimmendem Text in der Keyword-Eigenschaft und der Annotation-Eigenschaft von ReferenceDescriptor-Instanzen.
Die Liste von Suchzeichenfolgen wird durch Analysieren des eingegebenen Texts erstellt. Bei der Abfrage handelt es sich um eine parametrisierte ObjectQuery, die in einer Schleife verwendet wird, bei der jede Suchzeichenfolge in die Abfrage eingefügt und mit den Texten verglichen wird, die den Eigenschaften Keyword und Annotation von ReferenceDescriptor-Instanzen im Speicher zugewiesen sind. Die ObjectParameter-Klasse und die ObjectQuery-Klasse werden mit folgendem Codesegment instanziiert.
// Create ObjectParameter from each keyword.
ObjectParameter paramKeyword =
new ObjectParameter(
"p", "%" + keyword + "%");
ObjectQuery<ReferenceDescriptor>
descriptorQuery =
researchCollaborationData.
ReferenceDescriptor.Where(
"it.Annotation LIKE @p OR it.Keyword LIKE @p",
paramKeyword);
Jeder ReferenceDescriptor, der von der ObjectQuery zurückgegeben wird, tritt in eine Schleife ein, die die zugehörige Reference lädt. Dazu werden die dafür entworfenen NavigationProperty und Association verwendet. Im folgenden Codesegment werden die Reference geladen, die zugehörige Locator-Eigenschaft gelesen und die URL zur Reference als Link im Ergebnistextfeld angezeigt.
refDescriptor.ReferenceReference.Load();
Reference reference = refDescriptor.Reference;
textBoxAnnotationResults.Text =
textBoxAnnotationResults.Text + "\n" +
reference.Locator + "\n";
Schließlich sucht die Methode nach Informationen über mit der Reference verknüpfte Kontakte und zeigt diese an. Mit einer statischen Methode der LinkTable_Reference-Association wird nach den Verknüpfungstabellenentitäten gesucht, die der Reference zugeordnet sind. Instanzen von ContactPersonReference (die Verknüpfungstabellenentitäten, die die Reference enthalten) treten in eine Schleife ein, die Eigenschaften der verknüpften ContactPerson lädt und anzeigt. Die Eigenschaften FirstName, LastName, Title und Email werden zusammen mit den Reference-Annotation- und Locator-Texten angezeigt, die von vorangehendem Code gefunden wurden.
foreach (ContactPersonReference contactPersRef in
researchCollaborationData.ContactPersonReference)
{
contactPersRef.RelatedReferenceReference.Load();
if (contactPersRef.RelatedReferenceReference.Equals(
reference))
{
contactPersRef.RelatedContactReference.Load();
textBoxAnnotationResults.Text =
textBoxAnnotationResults.Text +
"\n" +
"Relevant Contact:";
textBoxAnnotationResults.Text =
textBoxAnnotationResults.Text +
"\n" +
contactPersRef.
RelatedContact.FirstName + " " +
contactPersRef.RelatedContact.
LastName +
" Title: " + contactPersRef.
RelatedContact.Title + " Email: "
+ contactPersRef.RelatedContact.
Email
+ "\n";
}
}
Suchen nach Kontakten zugeordneten Verweisen
Nach Instanzen von Reference, die mit ContactPerson-Instanzen verknüpft sind, kann mithilfe derselben Verknüpfungstabellenentität und Verknüpfungen wie im vorherigen Codesegment gesucht werden. Benutzer dieser Anwendung können nach Verweisseiten von einem Kontakt suchen, indem sie Text in die Textfelder LastName und/oder Email eingeben und auf die Schaltfläche Find Ref/Person klicken. Neue ObjectParameter-Instanzen werden aus den Texten in LastName und Email erstellt. Die Parameter werden von einer ObjectQuery verwendet, um nach einer Person mit entsprechendem Nachnamen oder entsprechender E-Mail-Adresse zu suchen. Mit der Any-Methode der ObjectQuery wird getestet, ob diese Abfrage Ergebnisse zurückgibt.
Wenn eine Instanz von ContactPerson mit entsprechendem Nachnamen oder entsprechender E-Mail-Adresse gefunden wird, werden die Kontaktinformationen mit den zugeordneten Reference-Dokumenten angezeigt. Nach den verknüpften Dokumenten wird wie in der vorherigen Methode mit der ContactPersonReference-Verknüpfungsentität und den zugehörigen Navigationseigenschaften gesucht.
private void buttonFindRefPerson_Click(object sender, EventArgs e)
{
ResearchCollaborationData researchCollaborationData = null;
try
{
using (researchCollaborationData =
new ResearchCollaborationData())
{
// Use parameters from LastName and
// Email text boxes in search.
ObjectParameter emailParam = new ObjectParameter(
"email", textBoxEmail.Text);
ObjectParameter nameParam = new ObjectParameter(
"name", textBoxLastName.Text);
ObjectParameter[] objParams = { emailParam,
nameParam };
ObjectQuery<ContactPerson> query =
researchCollaborationData.ContactPerson.Where(
"it.Email = @email OR it.LastName = @name",
objParams );
if (query.Any())
{
textBoxAnnotationResults.Text =
"Contact and associated reference documents:\n";
ContactPerson person = null;
query.FirstOrDefault(out person);
// Display contact information and
// related references.
textBoxAnnotationResults.Text =
textBoxAnnotationResults.Text +
person.FirstName + " " + person.LastName +
" Title: " + person.Title +
" Email address: " + person.Email;
ObjectParameter contactParam =
new ObjectParameter("p",
person.ContactPersonID);
foreach (ContactPersonReference contactReference
in researchCollaborationData.
ContactPersonReference.Where(
"it.RelatedContact.ContactPersonID = @p",
contactParam))
{
contactReference.RelatedReferenceReference.
Load();
textBoxAnnotationResults.Text =
textBoxAnnotationResults.Text + "\n" +
contactReference.RelatedReference.Locator;
}
}
}
}
catch (Exception exception)
{
MessageBox.Show(exception.ToString());
}
}
Vollständiger Code der Anwendungsereignishandler
Der folgende Code umfasst alle Ereignishandler, die zum Initialisieren der EntityConnection sowie zum Suchen und Aktualisieren von Daten verwendet werden, die auf Grundlage des Research Collaboration-Datenmodells erstellt werden.
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Text;
using System.Windows.Forms;
using System.Data.Common;
using System.Data.Objects;
using System.Linq;
using ResearchCollaborationDataModel;
namespace ResearchCollaboration
{
public partial class Form1 : Form
{
public Form1()
{
InitializeComponent();
try
{
webBrowser1.Navigate(
"http://www.live.com/?searchonly=true");
}
catch (Exception e)
{
MessageBox.Show(e.ToString());
}
}
private void buttonNavigate_Click(object sender, EventArgs e)
{
webBrowser1.Navigate(textBoxUri.Text);
}
private void buttonCreateRefDescriptor_Click(
object sender, EventArgs e)
{
ResearchCollaborationData researchCollaborationData = null;
try
{
using (researchCollaborationData =
new ResearchCollaborationData())
{
ObjectParameter param = new ObjectParameter(
"p", webBrowser1.Document.Url.ToString());
if (!researchCollaborationData.Reference.Where(
"it.Locator = @p", param).Any())
{
Reference newReference = new Reference();
newReference.ReferenceID = Guid.NewGuid();
newReference.Locator = webBrowser1.Document.Url.ToString();
researchCollaborationData.AddToReference(newReference);
ReferenceDescriptor newReferenceDescriptor =
new ReferenceDescriptor();
newReferenceDescriptor.DescriptorID = Guid.NewGuid();
newReferenceDescriptor.Keyword =
textBoxKeyWord.Text;
newReferenceDescriptor.Annotation =
textBoxAnnotationResults.Text;
researchCollaborationData.AddToReferenceDescriptor(newReferenceDescriptor);
newReference.RefDescriptors.Add(
newReferenceDescriptor);
}
else
{
Reference reference =
researchCollaborationData.Reference.Where(
"it.Locator = @p", param).First();
ReferenceDescriptor newReferenceDescriptor =
new ReferenceDescriptor();
newReferenceDescriptor.DescriptorID = Guid.NewGuid();
newReferenceDescriptor.Keyword =
textBoxKeyWord.Text;
newReferenceDescriptor.Annotation =
textBoxAnnotationResults.Text;
researchCollaborationData.AddToReferenceDescriptor(newReferenceDescriptor);
reference.RefDescriptors.Add(
newReferenceDescriptor);
}
researchCollaborationData.SaveChanges();
researchCollaborationData.Connection.Close();
}
}
catch(Exception exception)
{
MessageBox.Show(exception.ToString());
researchCollaborationData.Connection.Close();
}
}
private void buttonSearch_Click(object sender, EventArgs e)
{
ResearchCollaborationData researchCollaborationData = null;
try
{
using (researchCollaborationData =
new ResearchCollaborationData())
{
// Make a list of keywords to search for in annotatations.
List<string> keywords = new List<string>();
int i = 0;
int j = 0;
while (i < textBoxSearch.Text.Length)
{
j = textBoxSearch.Text.IndexOf(" ", i);
if (-1 == j) j = textBoxSearch.Text.Length;
keywords.Add(
textBoxSearch.Text.Substring(i, j - i));
i = ++j;
}
textBoxAnnotationResults.Text = "Results:";
foreach (string keyword in keywords)
{
// Create ObjectParameter from each keyword.
ObjectParameter paramKeyword =
new ObjectParameter(
"p", "%" + keyword + "%");
ObjectQuery<ReferenceDescriptor>
descriptorQuery =
researchCollaborationData.
ReferenceDescriptor.Where(
"it.Annotation LIKE @p OR it.Keyword LIKE @p",
paramKeyword);
foreach (ReferenceDescriptor refDescriptor
in descriptorQuery)
{
textBoxAnnotationResults.Text =
textBoxAnnotationResults.Text + "\n" +
refDescriptor.Keyword + "\n" +
refDescriptor.Annotation;
refDescriptor.ReferenceReference.Load();
Reference reference = refDescriptor.Reference;
textBoxAnnotationResults.Text =
textBoxAnnotationResults.Text + "\n" +
reference.Locator + "\n";
foreach (ContactPersonReference contactPersRef in
researchCollaborationData.ContactPersonReference)
{
contactPersRef.RelatedReferenceReference.Load();
if (contactPersRef.RelatedReferenceReference.Equals(
reference))
{
contactPersRef.RelatedContactReference.Load();
textBoxAnnotationResults.Text =
textBoxAnnotationResults.Text +
"\n" +
"Relevant Contact:";
textBoxAnnotationResults.Text =
textBoxAnnotationResults.Text +
"\n" +
contactPersRef.
RelatedContact.FirstName + " " +
contactPersRef.RelatedContact.
LastName +
" Title: " + contactPersRef.
RelatedContact.Title + " Email: "
+ contactPersRef.RelatedContact.
Email
+ "\n";
}
}
}
}
}
}
catch (Exception exception)
{
MessageBox.Show(exception.ToString());
}
}
private void buttonCreateRefPerson_Click(object sender,
EventArgs e)
{
ResearchCollaborationData researchCollaborationData = null;
try
{
using (researchCollaborationData =
new ResearchCollaborationData())
{
// There are four possible cases depending
// whether contact and reference exist.
ObjectParameter paramContact =
new ObjectParameter("p", textBoxEmail.Text);
if (!researchCollaborationData.ContactPerson.Where(
"it.Email = @p", paramContact).Any())
{
ObjectParameter paramReference =
new ObjectParameter("p",
webBrowser1.Document.Url.ToString());
if (!researchCollaborationData.Reference.Where(
"it.Locator = @p", paramReference).Any())
{
// Neither contact nor reference exist.
ContactPerson newContact = new ContactPerson();
newContact.ContactPersonID = Guid.NewGuid();
newContact.LastName = textBoxLastName.Text;
newContact.FirstName = textBoxFirstName.Text;
newContact.Email = textBoxEmail.Text;
newContact.Title =
textBoxTitlePosition.Text;
researchCollaborationData.AddToContactPerson(newContact);
Reference newReference = new Reference();
newReference.ReferenceID = Guid.NewGuid();
newReference.Locator = webBrowser1.Document.Url.ToString();
researchCollaborationData.AddToReference(newReference);
ContactPersonReference newLink =
new ContactPersonReference();
newLink.ContactPersonRefID = Guid.NewGuid();
newLink.RelatedContact = newContact;
newLink.RelatedReference = newReference;
researchCollaborationData.AddToContactPersonReference(newLink);
}
else
{
// Reference exists but contact doesn't.
Reference reference =
researchCollaborationData.Reference.
Where("it.Locator = @p",
paramReference).First();
ContactPerson newContact = new ContactPerson();
newContact.ContactPersonID = Guid.NewGuid();
newContact.LastName = textBoxLastName.Text;
newContact.FirstName = textBoxFirstName.Text;
newContact.Email = textBoxEmail.Text;
newContact.Title =
textBoxTitlePosition.Text;
researchCollaborationData.AddToContactPerson(newContact);
ContactPersonReference newLink = new ContactPersonReference();
newLink.ContactPersonRefID = Guid.NewGuid();
newLink.RelatedContact = newContact;
newLink.RelatedReference = reference;
researchCollaborationData.AddToContactPersonReference(newLink);
}
}
else
{
// Contact exists but reference doesn't.
ObjectParameter paramReference =
new ObjectParameter("p",
webBrowser1.Document.Url.ToString());
if (!researchCollaborationData.Reference.Where(
"it.Locator = @p", paramReference).Any())
{
ContactPerson contact =
researchCollaborationData.ContactPerson.
Where("it.Email = @p",
paramContact).First();
Reference newReference = new Reference();
newReference.ReferenceID = Guid.NewGuid();
newReference.Locator = webBrowser1.Document.Url.ToString();
researchCollaborationData.AddToReference(newReference);
ContactPersonReference newLink = new ContactPersonReference();
newLink.ContactPersonRefID = Guid.NewGuid();
newLink.RelatedContact = contact;
newLink.RelatedReference = newReference;
researchCollaborationData.AddToContactPersonReference(newLink);
}
else
{
// Contact and reference both exist.
Reference reference =
researchCollaborationData.Reference.
Where("it.Locator = @p",
paramReference).First();
ContactPerson contact =
researchCollaborationData.
ContactPerson.Where("it.Email = @p",
paramContact).First();
ContactPersonReference newLink = new ContactPersonReference();
newLink.ContactPersonRefID = Guid.NewGuid();
newLink.RelatedContact = contact;
newLink.RelatedReference = reference;
researchCollaborationData.AddToContactPersonReference(newLink);
}
}
researchCollaborationData.SaveChanges();
researchCollaborationData.Connection.Close();
}
}
catch (Exception exception)
{
MessageBox.Show(exception.ToString());
}
}
private void buttonFindRefPerson_Click(object sender, EventArgs e)
{
ResearchCollaborationData researchCollaborationData = null;
try
{
using (researchCollaborationData =
new ResearchCollaborationData())
{
// Use parameters from LastName and
// Email text boxes in search.
ObjectParameter emailParam = new ObjectParameter(
"email", textBoxEmail.Text);
ObjectParameter nameParam = new ObjectParameter(
"name", textBoxLastName.Text);
ObjectParameter[] objParams = { emailParam,
nameParam };
ObjectQuery<ContactPerson> query =
researchCollaborationData.ContactPerson.Where(
"it.Email = @email OR it.LastName = @name",
objParams );
if (query.Any())
{
textBoxAnnotationResults.Text =
"Contact and associated reference documents:\n";
ContactPerson person = null;
query.FirstOrDefault(out person);
// Display contact information and
// related references.
textBoxAnnotationResults.Text =
textBoxAnnotationResults.Text +
person.FirstName + " " + person.LastName +
" Title: " + person.Title +
" Email address: " + person.Email;
ObjectParameter contactParam =
new ObjectParameter("p",
person.ContactPersonID);
foreach (ContactPersonReference contactReference
in researchCollaborationData.
ContactPersonReference.Where(
"it.RelatedContact.ContactPersonID = @p",
contactParam))
{
contactReference.RelatedReferenceReference.
Load();
textBoxAnnotationResults.Text =
textBoxAnnotationResults.Text + "\n" +
contactReference.RelatedReference.Locator;
}
}
}
}
catch (Exception exception)
{
MessageBox.Show(exception.ToString());
}
}
private void textBoxUri_PreviewKeyDown(object sender,
PreviewKeyDownEventArgs e)
{
if (e.KeyCode.Equals(Keys.Return))
buttonNavigate_Click(this, System.EventArgs.Empty);
}
private void textBoxSearch_PreviewKeyDown(object sender,
PreviewKeyDownEventArgs e)
{
if (e.KeyCode.Equals(Keys.Return))
buttonSearch_Click(this, null);
}
private void textBoxAnnotationResults_LinkClicked(object sender,
LinkClickedEventArgs e)
{
// Display the Locator URL in Web browser.
webBrowser1.Navigate(e.LinkText);
}
private void webBrowser1_DocumentCompleted(object sender,
WebBrowserDocumentCompletedEventArgs e)
{
textBoxUri.Text = webBrowser1.Document.Url.ToString();
}
private void textBoxEmail_MouseDoubleClick(object sender,
MouseEventArgs e)
{
ResearchCollaborationData researchCollaborationData = null;
try
{
researchCollaborationData =
new ResearchCollaborationData();
textBoxAnnotationResults.Text =
"Contacts and related references:";
// Find and display all contacts and
// their related references.
foreach (ContactPerson person in
researchCollaborationData.ContactPerson)
{
textBoxAnnotationResults.Text =
textBoxAnnotationResults.Text + "\n\n" +
person.FirstName + " " + person.LastName +
" Title: " + person.Title +
" Email address: " + person.Email;
ObjectParameter contactParam = new ObjectParameter(
"p", person.ContactPersonID);
foreach (ContactPersonReference contactReference in
researchCollaborationData.ContactPersonReference.
Where("it.RelatedContact.ContactPersonID = @p",
contactParam))
{
contactReference.RelatedReferenceReference.Load();
textBoxAnnotationResults.Text =
textBoxAnnotationResults.Text +
"\n" +
contactReference.RelatedReference.Locator;
}
}
}
catch (Exception exception)
{
MessageBox.Show(exception.ToString());
}
}
private void textBoxSearch_MouseDoubleClick(object sender,
EventArgs e)
{
ResearchCollaborationData researchCollaborationData = null;
try
{
researchCollaborationData =
new ResearchCollaborationData();
textBoxAnnotationResults.Text =
"All references and related contacts:\n";
foreach (ReferenceDescriptor refDescriptor in
researchCollaborationData.ReferenceDescriptor)
{
textBoxAnnotationResults.Text =
textBoxAnnotationResults.Text + "\n" +
refDescriptor.Keyword + "\n" +
refDescriptor.Annotation;
refDescriptor.ReferenceReference.Load();
Reference reference = refDescriptor.Reference;
textBoxAnnotationResults.Text =
textBoxAnnotationResults.Text + "\n" +
reference.Locator + "\n";
foreach (ContactPersonReference contactPersonRef in
researchCollaborationData.ContactPersonReference)
{
if(contactPersonRef.Equals(reference))
{
contactPersonRef.RelatedContactReference.Load();
textBoxAnnotationResults.Text =
textBoxAnnotationResults.Text + "\n" +
"Relevant Contact:";
textBoxAnnotationResults.Text =
textBoxAnnotationResults.Text + "\n" +
contactPersonRef.RelatedContact.FirstName + " " +
contactPersonRef.RelatedContact.LastName + " Title: " +
contactPersonRef.RelatedContact.Title + " Email: " +
contactPersonRef.RelatedContact.Email + "\n";
}
}
}
}
catch (Exception exception)
{
MessageBox.Show(exception.ToString());
}
}
}
}
Siehe auch
Konzepte
Annotation and Research Collaboration Tool (EDM-Beispielanwendung)
Annotation Research Tool-Schemas (EDM-Beispielanwendung)