Class GraphPersistenceWrapper

The Graph Persistence Wrapper is a wrapper around another Graph that can be used to batch persistence actions with the ability to Flush/Discard changes as desired.

Inheritance

System.Object

GraphPersistenceWrapper

FileGraphPersistenceWrapper

StoreGraphPersistenceWrapper

Implements

ITransactionalGraph

IGraph

INodeFactory

System.IDisposable

System.Xml.Serialization.IXmlSerializable

Inherited Members

System.Object.Equals(System.Object, System.Object)

System.Object.GetHashCode()

System.Object.GetType()

System.Object.MemberwiseClone()

System.Object.ReferenceEquals(System.Object, System.Object)

System.Object.ToString()

Namespace: VDS.RDF

Assembly: dotNetRDF.dll

Syntax

[Serializable]
public class GraphPersistenceWrapper : ITransactionalGraph, IGraph, INodeFactory, IDisposable, IXmlSerializable

Remarks

When disposed any outstanding changes are always flushed so if you make changes which you don't want to persist be sure to call the Discard() method before disposing of the Graph.

Implementors who wish to make persistent graphs should extend this class and override the SupportsTriplePersistence property and the PersistInsertedTriples(IEnumerable<Triple>), PersistDeletedTriples(IEnumerable<Triple>) and PersistGraph() methods. If you return true for the property then the PersistInsertedTriples(IEnumerable<Triple>) and PersistDeletedTriples(IEnumerable<Triple>) methods will be invoked to do persistence on batches of Triples. If your persistence mechanism requires persisting the entire graph at once return false for the property and override the PersistGraph() method appropriately.

Warning

Note that the wrapper does not automatically dispose of the wrapped graph when the wrapper is Dispose, this is by design since disposing of the wrapped Graph can have unintended consequences.

Constructors

GraphPersistenceWrapper()

Creates a new Graph Persistence Wrapper around a new Graph.

Declaration

public GraphPersistenceWrapper()

GraphPersistenceWrapper(Boolean)

Creates a new Graph Persistence Wrapper around a new Graph with the given always queue setting.

Declaration

public GraphPersistenceWrapper(bool alwaysQueueActions)

Parameters

Type	Name	Description
System.Boolean	alwaysQueueActions	Whether to always queue actions.

Remarks

The alwaysQueueActions setting when enabled will cause the wrapper to queue Asserts and Retracts for persistence regardless of whether the relevant Triples already exist (i.e. normally if a Triple exists is cannot be asserted again and if it doesn't exist it cannot be retracted). This is useful for creating derived wrappers which operate in write-only mode i.e. append mode for an existing graph that may be too large to reasonably load into memory.

GraphPersistenceWrapper(SerializationInfo, StreamingContext)

Deserialization Constructor.

Declaration

protected GraphPersistenceWrapper(SerializationInfo info, StreamingContext context)

Parameters

Type	Name	Description
System.Runtime.Serialization.SerializationInfo	info	Serialization Information.
System.Runtime.Serialization.StreamingContext	context	Streaming Context.

GraphPersistenceWrapper(IGraph)

Creates a new Graph Persistence Wrapper around the given Graph.

Declaration

public GraphPersistenceWrapper(IGraph g)

Parameters

Type	Name	Description
IGraph	g	Graph.

GraphPersistenceWrapper(IGraph, Boolean)

Creates a new Graph Persistence Wrapper around the given Graph with the given always queue setting.

Declaration

public GraphPersistenceWrapper(IGraph g, bool alwaysQueueActions)

Parameters

Type	Name	Description
IGraph	g	Graph.
System.Boolean	alwaysQueueActions	Whether to always queue actions.

Remarks

The alwaysQueueActions setting when enabled will cause the wrapper to queue Asserts and Retracts for persistence regardless of whether the relevant Triples already exist (i.e. normally if a Triple exists is cannot be asserted again and if it doesn't exist it cannot be retracted). This is useful for creating derived wrappers which operate in write-only mode i.e. append mode for an existing graph that may be too large to reasonably load into memory.

Fields

_g

Underlying Graph this is a wrapper around.

Declaration

protected readonly IGraph _g

Field Value

Type	Description
IGraph

Properties

AllNodes

Gets the unique Subject, Predicate and Object nodes of the Graph.

Declaration

public IEnumerable<INode> AllNodes { get; }

Property Value

Type	Description
System.Collections.Generic.IEnumerable<INode>

BaseUri

Gets/Sets the Base URI of the Graph.

Declaration

public Uri BaseUri { get; set; }

Property Value

Type	Description
System.Uri

IsEmpty

Gets whether the Graph is empty.

Declaration

public bool IsEmpty { get; }

Property Value

Type	Description
System.Boolean

NamespaceMap

Gets the Namespace Map for the Graph.

Declaration

public INamespaceMapper NamespaceMap { get; }

Property Value

Type	Description
INamespaceMapper

Nodes

Gets the unique Subject and Object nodes of the Graph.

Declaration

public IEnumerable<INode> Nodes { get; }

Property Value

Type	Description
System.Collections.Generic.IEnumerable<INode>

Remarks

This property returns only nodes that appear in the Subject or Object position in triples. To retrieve a list of all INode instances in a graph including those in Predicate position in a triple, use the AllNodes property.

SupportsTriplePersistence

Used to indicate whether the persistence mechanism can persist batches of Triples.

Declaration

protected virtual bool SupportsTriplePersistence { get; }

Property Value

Type	Description
System.Boolean

Remarks

If true then the PersistInsertedTriples(IEnumerable<Triple>) and PersistDeletedTriples(IEnumerable<Triple>) methods are used to persist changes when the Flush() method is called. If false then the PersistGraph() method will be invoked instead.

Triples

Gets the Triple Collection for the Graph.

Declaration

public BaseTripleCollection Triples { get; }

Property Value

Type	Description
BaseTripleCollection

Methods

Assert(IEnumerable<Triple>)

Asserts Triples in the Graph.

Declaration

public bool Assert(IEnumerable<Triple> ts)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<Triple>	ts	Triples.

Returns

Type	Description
System.Boolean

Assert(Triple)

Asserts a Triple in the Graph.

Declaration

public virtual bool Assert(Triple t)

Parameters

Type	Name	Description
Triple	t	Triple.

Returns

Type	Description
System.Boolean

AttachEventHandlers(BaseTripleCollection)

Helper method for attaching the necessary event Handlers to a Triple Collection.

Declaration

protected void AttachEventHandlers(BaseTripleCollection tripleCollection)

Parameters

Type	Name	Description
BaseTripleCollection	tripleCollection	Triple Collection.

Remarks

May be useful if you replace the Triple Collection after instantiation e.g. as done in SparqlView's.

Clear()

Clears the Graph.

Declaration

public void Clear()

ContainsTriple(Triple)

Gets whether a given Triple exists in this Graph.

Declaration

public virtual bool ContainsTriple(Triple t)

Parameters

Type	Name	Description
Triple	t	Triple to test.

Returns

Type	Description
System.Boolean

CreateBlankNode()

Creates a new Blank Node.

Declaration

public IBlankNode CreateBlankNode()

Returns

Type	Description
IBlankNode

CreateBlankNode(String)

Creates a new Blank Node with the given Node ID.

Declaration

public IBlankNode CreateBlankNode(string nodeId)

Parameters

Type	Name	Description
System.String	nodeId	Node ID.

Returns

Type	Description
IBlankNode

CreateGraphLiteralNode()

Creates a new Graph Literal Node.

Declaration

public IGraphLiteralNode CreateGraphLiteralNode()

Returns

Type	Description
IGraphLiteralNode

CreateGraphLiteralNode(IGraph)

Creates a new Graph Literal Node with the given sub-graph.

Declaration

public IGraphLiteralNode CreateGraphLiteralNode(IGraph subgraph)

Parameters

Type	Name	Description
IGraph	subgraph	Sub-graph.

Returns

Type	Description
IGraphLiteralNode

CreateLiteralNode(String)

Creates a new Literal Node.

Declaration

public ILiteralNode CreateLiteralNode(string literal)

Parameters

Type	Name	Description
System.String	literal	Value.

Returns

Type	Description
ILiteralNode

CreateLiteralNode(String, String)

Creates a new Literal Node with the given Language.

Declaration

public ILiteralNode CreateLiteralNode(string literal, string langspec)

Parameters

Type	Name	Description
System.String	literal	Value.
System.String	langspec	Language.

Returns

Type	Description
ILiteralNode

CreateLiteralNode(String, Uri)

Creates a new Literal Node with the given Datatype.

Declaration

public ILiteralNode CreateLiteralNode(string literal, Uri datatype)

Parameters

Type	Name	Description
System.String	literal	Value.
System.Uri	datatype	Datatype URI.

Returns

Type	Description
ILiteralNode

CreateUriNode()

Creates a new URI Node that references the Graphs Base URI.

Declaration

public IUriNode CreateUriNode()

Returns

Type	Description
IUriNode

CreateUriNode(String)

Creates a new URI Node from a QName.

Declaration

public IUriNode CreateUriNode(string qname)

Parameters

Type	Name	Description
System.String	qname	QName.

Returns

Type	Description
IUriNode

CreateUriNode(Uri)

Creates a new URI Node.

Declaration

public IUriNode CreateUriNode(Uri uri)

Parameters

Type	Name	Description
System.Uri	uri	URI.

Returns

Type	Description
IUriNode

CreateVariableNode(String)

Creates a new Variable Node.

Declaration

public IVariableNode CreateVariableNode(string varname)

Parameters

Type	Name	Description
System.String	varname	Variable Name.

Returns

Type	Description
IVariableNode

DetachEventHandlers(BaseTripleCollection)

Helper method for detaching the necessary event Handlers from a Triple Collection.

Declaration

protected void DetachEventHandlers(BaseTripleCollection tripleCollection)

Parameters

Type	Name	Description
BaseTripleCollection	tripleCollection	Triple Collection.

Remarks

May be useful if you replace the Triple Collection after instantiation e.g. as done in SparqlView's.

Difference(IGraph)

Computes the Difference between this Graph the given Graph.

Declaration

public GraphDiffReport Difference(IGraph g)

Parameters

Type	Name	Description
IGraph	g	Graph.

Returns

Type	Description
GraphDiffReport

Remarks

Produces a report which shows the changes that must be made to this Graph to produce the given Graph.

Discard()

Discards all changes which have yet to be persisted so that they are not persisted to the underlying storage.

Declaration

public void Discard()

Dispose()

Disposes of the persistence wrapper and in doing so persists any changes to the underlying storage.

Declaration

public void Dispose()

Dispose(Boolean)

Disposes of the persistence wrapper and in doing so persists any changes to the underlying storage.

Declaration

protected void Dispose(bool disposing)

Parameters

Type	Name	Description
System.Boolean	disposing	Whether the method was called from Dispose() or the destructor.

Equals(Object)

Determines whether a Graph is equal to another Object.

Declaration

public override bool Equals(object obj)

Parameters

Type	Name	Description
System.Object	obj	Object to test.

Returns

Type	Description
System.Boolean

Overrides

System.Object.Equals(System.Object)

Remarks

A Graph can only be equal to another Object which is an IGraph.

Graph Equality is determined by a somewhat complex algorithm which is explained in the remarks of the other overload for Equals.

Equals(IGraph, out Dictionary<INode, INode>)

Determines whether this Graph is equal to the given Graph.

Declaration

public bool Equals(IGraph g, out Dictionary<INode, INode> mapping)

Parameters

Type	Name	Description
IGraph	g	Graph to test for equality.
System.Collections.Generic.Dictionary<INode, INode>	mapping	Mapping of Blank Nodes iff the Graphs are equal and contain some Blank Nodes.

Returns

Type	Description
System.Boolean

Remarks

The algorithm used to determine Graph equality is based in part on a Iterative Vertex Classification Algorithm described in a Technical Report from HP by Jeremy J Carroll -. Matching RDF Graphs

Graph Equality is determined according to the following algorithm:.

1. If the given Graph is null Graphs are not equal
2. If the given Graph is this Graph (as determined by Reference Equality) then Graphs are equal
3. If the Graphs have a different number of Triples they are not equal
4. Declare a list of Triples which are the Triples of the given Graph called OtherTriples
5. Declare two dictionaries of Nodes to Integers which are called LocalClassification and OtherClassification
6. For Each Triple in this Graph
   1. If it is a Ground Triple and cannot be found and removed from OtherTriples then Graphs are not equal since the Triple does not exist in both Graphs
   2. If it contains Blank Nodes track the number of usages of this Blank Node in LocalClassification
7. If there are any Triples remaining in OtherTriples which are Ground Triples then Graphs are not equal since this Graph does not contain them
8. If all the Triples from both Graphs were Ground Triples and there were no Blank Nodes then the Graphs are equal
9. Iterate over the remaining Triples in OtherTriples and populate the OtherClassification
10. If the count of the two classifications is different the Graphs are not equal since there are differing numbers of Blank Nodes in the Graph
11. Now build two additional dictionaries of Integers to Integers which are called LocalDegreeClassification and OtherDegreeClassification. Iterate over LocalClassification and OtherClassification such that the corresponding degree classifications contain a mapping of the number of Blank Nodes with a given degree
12. If the count of the two degree classifications is different the Graphs are not equal since there are not the same range of Blank Node degrees in both Graphs
13. For All classifications in LocalDegreeClassification there must be a matching classification in OtherDegreeClassification else the Graphs are not equal
14. Then build a possible mapping using the following rules:
    1. Any Blank Node used only once should be mapped to an equivalent Blank Node in the other Graph. If this is not possible then the Graphs are not equal
    2. Any Blank Node with a unique degree should be mapped to an equivalent Blank Node in the other Graph. If this is not possible then the Graphs are not equal
    3. Keep a copy of the mapping up to this point as a Base Mapping for use as a fallback in later steps
    4. Build up lists of dependent pairs of Blank Nodes for both Graphs
    5. Use these lists to determine if there are any independent nodes not yet mapped. These should be mapped to equivalent Blank Nodes in the other Graph, if this is not possible the Graphs are not equal
    6. Use the Dependencies and existing mappings to generate a possible mapping
    7. If a Complete Possible Mapping (there is a Mapping for each Blank Node from this Graph to the Other Graph) then test this mapping. If it succeeds then the Graphs are equal
    8. Otherwise we now fallback to the Base Mapping and use it as a basis for Brute Forcing the possible solution space and testing every possibility until either a mapping works or we find the Graphs to be non-equal

Finalize()

Destructor for the wrapper to ensure that Dispose() is called and thus that persistence happens

Declaration

protected void Finalize()

Flush()

Flushes all changes which have yet to be persisted to the underlying storage.

Declaration

public void Flush()

GetBlankNode(String)

Attempts to get the Blank Node with the given ID.

Declaration

public IBlankNode GetBlankNode(string nodeId)

Parameters

Type	Name	Description
System.String	nodeId	Node ID.

Returns

Type	Description
IBlankNode	The Node if it exists or null.

GetLiteralNode(String)

Attempts to get the Literal Node with the given Value.

Declaration

public ILiteralNode GetLiteralNode(string literal)

Parameters

Type	Name	Description
System.String	literal	Value.

Returns

Type	Description
ILiteralNode	The Node if it exists or null.

GetLiteralNode(String, String)

Attempts to get the Literal Node with the given Value and Language.

Declaration

public ILiteralNode GetLiteralNode(string literal, string langspec)

Parameters

Type	Name	Description
System.String	literal	Value.
System.String	langspec	Language.

Returns

Type	Description
ILiteralNode	The Node if it exists or null.

GetLiteralNode(String, Uri)

Attempts to get the Literal Node with the given Value and Datatype.

Declaration

public ILiteralNode GetLiteralNode(string literal, Uri datatype)

Parameters

Type	Name	Description
System.String	literal	Value.
System.Uri	datatype	Datatype URI.

Returns

Type	Description
ILiteralNode	The Node if it exists or null otherwise.

GetNextBlankNodeID()

Gets the next available Blank Node ID.

Declaration

public string GetNextBlankNodeID()

Returns

Type	Description
System.String

GetObjectData(SerializationInfo, StreamingContext)

Gets the Serialization Information.

Declaration

public void GetObjectData(SerializationInfo info, StreamingContext context)

Parameters

Type	Name	Description
System.Runtime.Serialization.SerializationInfo	info	Serialization Information.
System.Runtime.Serialization.StreamingContext	context	Streaming Context.

GetSchema()

Gets the Schema for XML serialization.

Declaration

public XmlSchema GetSchema()

Returns

Type	Description
System.Xml.Schema.XmlSchema

GetTriples(Uri)

Gets all the Triples involving the given URI.

Declaration

public IEnumerable<Triple> GetTriples(Uri uri)

Parameters

Type	Name	Description
System.Uri	uri	The URI to find Triples involving.

Returns

Type	Description
System.Collections.Generic.IEnumerable<Triple>	Zero/More Triples.

GetTriples(INode)

Gets all the Triples involving the given Node.

Declaration

public IEnumerable<Triple> GetTriples(INode n)

Parameters

Type	Name	Description
INode	n	The Node to find Triples involving.

Returns

Type	Description
System.Collections.Generic.IEnumerable<Triple>	Zero/More Triples.

GetTriplesWithObject(Uri)

Gets all the Triples with the given URI as the Object.

Declaration

public IEnumerable<Triple> GetTriplesWithObject(Uri u)

Parameters

Type	Name	Description
System.Uri	u	The URI to find Triples with it as the Object.

Returns

Type	Description
System.Collections.Generic.IEnumerable<Triple>	Zero/More Triples.

GetTriplesWithObject(INode)

Gets all the Triples with the given Node as the Object.

Declaration

public IEnumerable<Triple> GetTriplesWithObject(INode n)

Parameters

Type	Name	Description
INode	n	The Node to find Triples with it as the Object.

Returns

Type	Description
System.Collections.Generic.IEnumerable<Triple>

GetTriplesWithPredicate(Uri)

Gets all the Triples with the given Uri as the Predicate.

Declaration

public IEnumerable<Triple> GetTriplesWithPredicate(Uri u)

Parameters

Type	Name	Description
System.Uri	u	The Uri to find Triples with it as the Predicate.

Returns

Type	Description
System.Collections.Generic.IEnumerable<Triple>	Zero/More Triples.

GetTriplesWithPredicate(INode)

Gets all the Triples with the given Node as the Predicate.

Declaration

public IEnumerable<Triple> GetTriplesWithPredicate(INode n)

Parameters

Type	Name	Description
INode	n	The Node to find Triples with it as the Predicate.

Returns

Type	Description
System.Collections.Generic.IEnumerable<Triple>

GetTriplesWithPredicateObject(INode, INode)

Selects all Triples with the given Predicate and Object.

Declaration

public IEnumerable<Triple> GetTriplesWithPredicateObject(INode pred, INode obj)

Parameters

Type	Name	Description
INode	pred	Predicate.
INode	obj	Object.

Returns

Type	Description
System.Collections.Generic.IEnumerable<Triple>

GetTriplesWithSubject(Uri)

Gets all the Triples with the given Uri as the Subject.

Declaration

public IEnumerable<Triple> GetTriplesWithSubject(Uri u)

Parameters

Type	Name	Description
System.Uri	u	The Uri to find Triples with it as the Subject.

Returns

Type	Description
System.Collections.Generic.IEnumerable<Triple>	Zero/More Triples.

GetTriplesWithSubject(INode)

Gets all the Triples with the given Node as the Subject.

Declaration

public IEnumerable<Triple> GetTriplesWithSubject(INode n)

Parameters

Type	Name	Description
INode	n	The Node to find Triples with it as the Subject.

Returns

Type	Description
System.Collections.Generic.IEnumerable<Triple>	Zero/More Triples.

GetTriplesWithSubjectObject(INode, INode)

Selects all Triples with the given Subject and Object.

Declaration

public IEnumerable<Triple> GetTriplesWithSubjectObject(INode subj, INode obj)

Parameters

Type	Name	Description
INode	subj	Subject.
INode	obj	Object.

Returns

Type	Description
System.Collections.Generic.IEnumerable<Triple>

GetTriplesWithSubjectPredicate(INode, INode)

Selects all Triples with the given Subject and Predicate.

Declaration

public IEnumerable<Triple> GetTriplesWithSubjectPredicate(INode subj, INode pred)

Parameters

Type	Name	Description
INode	subj	Subject.
INode	pred	Predicate.

Returns

Type	Description
System.Collections.Generic.IEnumerable<Triple>

GetUriNode(String)

Returns the UriNode with the given QName if it exists.

Declaration

public IUriNode GetUriNode(string qname)

Parameters

Type	Name	Description
System.String	qname	The QName of the Node to select.

Returns

Type	Description
IUriNode

GetUriNode(Uri)

Returns the UriNode with the given Uri if it exists.

Declaration

public IUriNode GetUriNode(Uri uri)

Parameters

Type	Name	Description
System.Uri	uri	The Uri of the Node to select.

Returns

Type	Description
IUriNode	Either the UriNode Or null if no Node with the given Uri exists.

HasSubGraph(IGraph)

Checks whether this Graph has the given Graph as a sub-graph.

Declaration

public bool HasSubGraph(IGraph g)

Parameters

Type	Name	Description
IGraph	g	Graph.

Returns

Type	Description
System.Boolean

HasSubGraph(IGraph, out Dictionary<INode, INode>)

Checks whether this Graph has the given Graph as a sub-graph.

Declaration

public bool HasSubGraph(IGraph g, out Dictionary<INode, INode> mapping)

Parameters

Type	Name	Description
IGraph	g	Graph.
System.Collections.Generic.Dictionary<INode, INode>	mapping	Mapping of Blank Nodes.

Returns

Type	Description
System.Boolean

IsSubGraphOf(IGraph)

Checks whether this Graph is a sub-graph of the given Graph.

Declaration

public bool IsSubGraphOf(IGraph g)

Parameters

Type	Name	Description
IGraph	g	Graph.

Returns

Type	Description
System.Boolean

IsSubGraphOf(IGraph, out Dictionary<INode, INode>)

Checks whether this Graph is a sub-graph of the given Graph.

Declaration

public bool IsSubGraphOf(IGraph g, out Dictionary<INode, INode> mapping)

Parameters

Type	Name	Description
IGraph	g	Graph.
System.Collections.Generic.Dictionary<INode, INode>	mapping	Mapping of Blank Nodes.

Returns

Type	Description
System.Boolean

Merge(IGraph)

Merges another Graph into the current Graph.

Declaration

public virtual void Merge(IGraph g)

Parameters

Type	Name	Description
IGraph	g	Graph to Merge into this Graph.

Remarks

The Graph on which you invoke this method will preserve its Blank Node IDs while the Blank Nodes from the Graph being merged in will be given new IDs as required in the scope of this Graph.

Merge(IGraph, Boolean)

Merges another Graph into the current Graph.

Declaration

public virtual void Merge(IGraph g, bool keepOriginalGraphUri)

Parameters

Type	Name	Description
IGraph	g	Graph to Merge into this Graph.
System.Boolean	keepOriginalGraphUri	Indicates that the Merge should preserve the Graph URIs of Nodes so they refer to the Graph they originated in.

Remarks

The Graph on which you invoke this method will preserve its Blank Node IDs while the Blank Nodes from the Graph being merged in will be given new IDs as required in the scope of this Graph.

The Graph will raise the MergeRequested event before the Merge operation which gives any event handlers the oppurtunity to cancel this event. When the Merge operation is completed the Merged event is raised.

OnTripleAsserted(Object, TripleEventArgs)

Event Handler which handles the TripleAdded event from the underlying Triple Collection by raising the Graph's TripleAsserted event.

Declaration

protected virtual void OnTripleAsserted(object sender, TripleEventArgs args)

Parameters

Type	Name	Description
System.Object	sender	Sender.
TripleEventArgs	args	Triple Event Arguments.

OnTripleRetracted(Object, TripleEventArgs)

Event Handler which handles the TripleRemoved event from the underlying Triple Collection by raising the Graph's TripleRetracted event.

Declaration

protected virtual void OnTripleRetracted(object sender, TripleEventArgs args)

Parameters

Type	Name	Description
System.Object	sender	Sender.
TripleEventArgs	args	Triple Event Arguments.

PersistDeletedTriples(IEnumerable<Triple>)

Persists deleted Triples to the underlying Storage.

Declaration

protected virtual void PersistDeletedTriples(IEnumerable<Triple> ts)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<Triple>	ts

PersistGraph()

Persists the entire Graph to the underlying Storage.

Declaration

protected virtual void PersistGraph()

PersistInsertedTriples(IEnumerable<Triple>)

Persists inserted Triples to the underlying Storage.

Declaration

protected virtual void PersistInsertedTriples(IEnumerable<Triple> ts)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<Triple>	ts	Triples.

RaiseCleared()

Helper method for raising the Cleared event.

Declaration

protected void RaiseCleared()

RaiseClearRequested()

Helper method for raising the ClearRequested event and returning whether any of the Event Handlers cancelled the operation.

Declaration

protected bool RaiseClearRequested()

Returns

Type	Description
System.Boolean	True if the operation can continue, false if it should be aborted.

RaiseGraphChanged()

Helper method for raising the Changed event.

Declaration

protected void RaiseGraphChanged()

RaiseGraphChanged(TripleEventArgs)

Helper method for raising the Changed event.

Declaration

protected void RaiseGraphChanged(TripleEventArgs args)

Parameters

Type	Name	Description
TripleEventArgs	args	Triple Event Arguments.

RaiseMerged()

Helper method for raising the Merged event.

Declaration

protected void RaiseMerged()

RaiseMergeRequested()

Helper method for raising the MergeRequested event and returning whether any of the Event Handlers cancelled the operation.

Declaration

protected bool RaiseMergeRequested()

Returns

Type	Description
System.Boolean	True if the operation can continue, false if it should be aborted.

RaiseTripleAsserted(Triple)

Helper method for raising the TripleAsserted event manually.

Declaration

protected void RaiseTripleAsserted(Triple t)

Parameters

Type	Name	Description
Triple	t	Triple.

RaiseTripleAsserted(TripleEventArgs)

Helper method for raising the TripleAsserted event manually.

Declaration

protected void RaiseTripleAsserted(TripleEventArgs args)

Parameters

Type	Name	Description
TripleEventArgs	args	Triple Event Arguments.

RaiseTripleRetracted(Triple)

Helper method for raising the TripleRetracted event manually.

Declaration

protected void RaiseTripleRetracted(Triple t)

Parameters

Type	Name	Description
Triple	t	Triple.

RaiseTripleRetracted(TripleEventArgs)

Helper method for raising the TripleRetracted event manually.

Declaration

protected void RaiseTripleRetracted(TripleEventArgs args)

Parameters

Type	Name	Description
TripleEventArgs	args

ReadXml(XmlReader)

Reads the data for XML deserialization.

Declaration

public void ReadXml(XmlReader reader)

Parameters

Type	Name	Description
System.Xml.XmlReader	reader	XML Reader.

ResolveQName(String)

Helper function for Resolving QNames to URIs.

Declaration

public Uri ResolveQName(string qname)

Parameters

Type	Name	Description
System.String	qname	QName to resolve to a Uri.

Returns

Type	Description
System.Uri

Retract(IEnumerable<Triple>)

Retracts Triples from the Graph.

Declaration

public bool Retract(IEnumerable<Triple> ts)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<Triple>	ts	Triples.

Returns

Type	Description
System.Boolean

Retract(Triple)

Retracts a Triple from the Graph.

Declaration

public virtual bool Retract(Triple t)

Parameters

Type	Name	Description
Triple	t	Triple.

Returns

Type	Description
System.Boolean

WriteXml(XmlWriter)

Writes the data for XML serialization.

Declaration

public void WriteXml(XmlWriter writer)

Parameters

Type	Name	Description
System.Xml.XmlWriter	writer	XML Writer.

Events

Changed

Event which is raised when the Graph contents change

Declaration

public event GraphEventHandler Changed

Event Type

Type	Description
GraphEventHandler

Cleared

Event which is raised after the Graph is cleared of its contents

Declaration

public event GraphEventHandler Cleared

Event Type

Type	Description
GraphEventHandler

ClearRequested

Event which is raised just before the Graph is cleared of its contents

Declaration

public event CancellableGraphEventHandler ClearRequested

Event Type

Type	Description
CancellableGraphEventHandler

Merged

Event which is raised when a Merge operation is completed on the Graph

Declaration

public event GraphEventHandler Merged

Event Type

Type	Description
GraphEventHandler

MergeRequested

Event which is raised when a Merge operation is requested on the Graph

Declaration

public event CancellableGraphEventHandler MergeRequested

Event Type

Type	Description
CancellableGraphEventHandler

TripleAsserted

Event which is raised when a Triple is asserted in the Graph

Declaration

public event TripleEventHandler TripleAsserted

Event Type

Type	Description
TripleEventHandler

TripleRetracted

Event which is raised when a Triple is retracted from the Graph

Declaration

public event TripleEventHandler TripleRetracted

Event Type

Type	Description
TripleEventHandler

Implements

ITransactionalGraph

IGraph

INodeFactory

System.IDisposable

System.Xml.Serialization.IXmlSerializable

Extension Methods

GraphExtensions.ToDataTable(IGraph)

Extensions.AsEnumerable<T>(T)

Extensions.Assert(IGraph, INode, INode, INode)

Extensions.Retract(IGraph, INode, INode, INode)

Extensions.AssertList<T>(IGraph, IEnumerable<T>, Func<T, INode>)

Extensions.AssertList<T>(IGraph, INode, IEnumerable<T>, Func<T, INode>)

Extensions.AssertList(IGraph, IEnumerable<INode>)

Extensions.AssertList(IGraph, INode, IEnumerable<INode>)

Extensions.GetListAsTriples(IGraph, INode)

Extensions.GetListItems(IGraph, INode)

Extensions.GetListNodes(IGraph, INode)

Extensions.RetractList(IGraph, INode)

Extensions.AddToList<T>(IGraph, INode, IEnumerable<T>, Func<T, INode>)

Extensions.AddToList(IGraph, INode, IEnumerable<INode>)

Extensions.RemoveFromList<T>(IGraph, INode, IEnumerable<T>, Func<T, INode>)

Extensions.RemoveFromList(IGraph, INode, IEnumerable<INode>)

GraphExtensions.ExecuteQuery(IGraph, String)

GraphExtensions.ExecuteQuery(IGraph, IRdfHandler, ISparqlResultsHandler, String)

GraphExtensions.ExecuteQuery(IGraph, SparqlParameterizedString)

GraphExtensions.ExecuteQuery(IGraph, IRdfHandler, ISparqlResultsHandler, SparqlParameterizedString)

GraphExtensions.ExecuteQuery(IGraph, SparqlQuery)

GraphExtensions.ExecuteQuery(IGraph, IRdfHandler, ISparqlResultsHandler, SparqlQuery)

GraphExtensions.LoadFromFile(IGraph, String, IRdfReader)

GraphExtensions.LoadFromFile(IGraph, String)

GraphExtensions.LoadFromUri(IGraph, Uri, IRdfReader)

GraphExtensions.LoadFromUri(IGraph, Uri)

GraphExtensions.LoadFromString(IGraph, String, IRdfReader)

GraphExtensions.LoadFromString(IGraph, String)

GraphExtensions.LoadFromEmbeddedResource(IGraph, String)

GraphExtensions.LoadFromEmbeddedResource(IGraph, String, IRdfReader)

GraphExtensions.SaveToFile(IGraph, String, IRdfWriter)

GraphExtensions.SaveToFile(IGraph, String, IStoreWriter)

GraphExtensions.SaveToFile(IGraph, String)

GraphExtensions.SaveToStream(IGraph, TextWriter, IRdfWriter)

GraphExtensions.SaveToStream(IGraph, TextWriter, IStoreWriter)

GraphExtensions.SaveToStream(IGraph, String, TextWriter)

DynamicExtensions.AsDynamic(IGraph, Uri, Uri)