GraphPersistenceWrapper Class |
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 HierarchySystemObject
VDS.RDFGraphPersistenceWrapper
VDS.RDFFileGraphPersistenceWrapper
VDS.RDFStoreGraphPersistenceWrapper
VDS.RDFGraphPersistenceWrapper
VDS.RDFFileGraphPersistenceWrapper
VDS.RDFStoreGraphPersistenceWrapper
Namespace: VDS.RDF
Assembly: dotNetRDF (in dotNetRDF.dll) Version:
SyntaxThe GraphPersistenceWrapper type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | GraphPersistenceWrapper |
Creates a new Graph Persistence Wrapper around a new Graph.
|
| GraphPersistenceWrapper(Boolean) |
Creates a new Graph Persistence Wrapper around a new Graph with the given always queue setting.
|
| GraphPersistenceWrapper(IGraph) |
Creates a new Graph Persistence Wrapper around the given Graph.
|
 | GraphPersistenceWrapper(SerializationInfo, StreamingContext) |
Deserialization Constructor.
|
| GraphPersistenceWrapper(IGraph, Boolean) |
Creates a new Graph Persistence Wrapper around the given Graph with the given always queue setting.
|
Properties| Name | Description | |
|---|---|---|
 | AllNodes |
Gets the unique Subject, Predicate and Object nodes of the Graph.
|
| BaseUri |
Gets/Sets the Base URI of the Graph.
|
| IsEmpty |
Gets whether the Graph is empty.
|
| NamespaceMap |
Gets the Namespace Map for the Graph.
|
| Nodes |
Gets the unique Subject and Object nodes of the Graph.
|
 | SupportsTriplePersistence |
Used to indicate whether the persistence mechansim can persist batches of Triples.
|
| Triples |
Gets the Triple Collection for the Graph.
|
Methods| Name | Description | |
|---|---|---|
| Assert(IEnumerableTriple) |
Asserts Triples in the Graph.
|
| Assert(Triple) |
Asserts a Triple in the Graph.
|
| AttachEventHandlers |
Helper method for attaching the necessary event Handlers to a Triple Collection.
|
| Clear |
Clears the Graph.
|
| ContainsTriple |
Gets whether a given Triple exists in this Graph.
|
| CreateBlankNode |
Creates a new Blank Node.
|
| CreateBlankNode(String) |
Creates a new Blank Node with the given Node ID.
|
| CreateGraphLiteralNode |
Creates a new Graph Literal Node.
|
| CreateGraphLiteralNode(IGraph) |
Creates a new Graph Literal Node with the given sub-graph.
|
| CreateLiteralNode(String) |
Creates a new Literal Node.
|
| CreateLiteralNode(String, String) |
Creates a new Literal Node with the given Language.
|
| CreateLiteralNode(String, Uri) |
Creates a new Literal Node with the given Datatype.
|
| CreateUriNode |
Creates a new URI Node that references the Graphs Base URI.
|
| CreateUriNode(String) |
Creates a new URI Node from a QName.
|
| CreateUriNode(Uri) |
Creates a new URI Node.
|
| CreateVariableNode |
Creates a new Variable Node.
|
| DetachEventHandlers |
Helper method for detaching the necessary event Handlers from a Triple Collection.
|
| Difference |
Computes the Difference between this Graph the given Graph.
|
| Discard |
Discards all changes which have yet to be persisted so that they are not persisted to the underlying storage.
|
| Dispose |
Disposes of the persistence wrapper and in doing so persists any changes to the underlying storage.
|
| Dispose(Boolean) |
Disposes of the persistence wrapper and in doing so persists any changes to the underlying storage.
|
| Equals(Object) |
Determines whether a Graph is equal to another Object.
(Overrides ObjectEquals(Object).) |
| Equals(IGraph, DictionaryINode, INode) |
Determines whether this Graph is equal to the given Graph.
|
| Finalize |
Destructor for the wrapper to ensure that Dispose() is called and thus that persistence happens
(Overrides ObjectFinalize.) |
| Flush |
Flushes all changes which have yet to be persisted to the underlying storage.
|
| GetBlankNode |
Attempts to get the Blank Node with the given ID.
|
| GetHashCode | Serves as the default hash function. (Inherited from Object.) |
| GetLiteralNode(String) |
Attempts to get the Literal Node with the given Value.
|
| GetLiteralNode(String, String) |
Attempts to get the Literal Node with the given Value and Language.
|
| GetLiteralNode(String, Uri) |
Attempts to get the Literal Node with the given Value and Datatype.
|
| GetNextBlankNodeID |
Gets the next available Blank Node ID.
|
| GetObjectData |
Gets the Serialization Information.
|
| GetSchema |
Gets the Schema for XML serialization.
|
| GetTriples(Uri) |
Gets all the Triples involving the given URI.
|
| GetTriples(INode) |
Gets all the Triples involving the given Node.
|
| GetTriplesWithObject(Uri) |
Gets all the Triples with the given URI as the Object.
|
| GetTriplesWithObject(INode) |
Gets all the Triples with the given Node as the Object.
|
| GetTriplesWithPredicate(Uri) |
Gets all the Triples with the given Uri as the Predicate.
|
| GetTriplesWithPredicate(INode) |
Gets all the Triples with the given Node as the Predicate.
|
| GetTriplesWithPredicateObject |
Selects all Triples with the given Predicate and Object.
|
| GetTriplesWithSubject(Uri) |
Gets all the Triples with the given Uri as the Subject.
|
| GetTriplesWithSubject(INode) |
Gets all the Triples with the given Node as the Subject.
|
| GetTriplesWithSubjectObject |
Selects all Triples with the given Subject and Object.
|
| GetTriplesWithSubjectPredicate |
Selects all Triples with the given Subject and Predicate.
|
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| GetUriNode(String) |
Returns the UriNode with the given QName if it exists.
|
| GetUriNode(Uri) |
Returns the UriNode with the given Uri if it exists.
|
| HasSubGraph(IGraph) |
Checks whether this Graph has the given Graph as a sub-graph.
|
| HasSubGraph(IGraph, DictionaryINode, INode) |
Checks whether this Graph has the given Graph as a sub-graph.
|
| IsSubGraphOf(IGraph) |
Checks whether this Graph is a sub-graph of the given Graph.
|
| IsSubGraphOf(IGraph, DictionaryINode, INode) |
Checks whether this Graph is a sub-graph of the given Graph.
|
| MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
| Merge(IGraph) |
Merges another Graph into the current Graph.
|
| Merge(IGraph, Boolean) |
Merges another Graph into the current Graph.
|
| OnTripleAsserted |
Event Handler which handles the Triple Added event from the underlying Triple Collection by raising the Graph's TripleAsserted event.
|
| OnTripleRetracted |
Event Handler which handles the Triple Removed event from the underlying Triple Collection by raising the Graph's Triple Retracted event.
|
| PersistDeletedTriples |
Persists deleted Triples to the underlying Storage.
|
| PersistGraph |
Persists the entire Graph to the underlying Storage.
|
| PersistInsertedTriples |
Persists inserted Triples to the underlying Storage.
|
| RaiseCleared |
Helper method for raising the Cleared event.
|
| RaiseClearRequested |
Helper method for raising the Clear Requested event and returning whether any of the Event Handlers cancelled the operation.
|
| RaiseGraphChanged |
Helper method for raising the Changed event.
|
| RaiseGraphChanged(TripleEventArgs) |
Helper method for raising the Changed event.
|
| RaiseMerged |
Helper method for raising the Merged event.
|
| RaiseMergeRequested |
Helper method for raising the Merge Requested event and returning whether any of the Event Handlers cancelled the operation.
|
| RaiseTripleAsserted(Triple) |
Helper method for raising the Triple Asserted event manually.
|
| RaiseTripleAsserted(TripleEventArgs) |
Helper method for raising the Triple Asserted event manually.
|
| RaiseTripleRetracted(Triple) |
Helper method for raising the Triple Retracted event manually.
|
| RaiseTripleRetracted(TripleEventArgs) |
Helper method for raising the Triple Retracted event manually.
|
| ReadXml |
Reads the data for XML deserialization.
|
| ResolveQName |
Helper function for Resolving QNames to URIs.
|
| Retract(IEnumerableTriple) |
Retracts Triples from the Graph.
|
| Retract(Triple) |
Retracts a Triple from the Graph.
|
| ToString | Returns a string that represents the current object. (Inherited from Object.) |
| WriteXml |
Writes the data for XML serialization.
|
Events| Name | Description | |
|---|---|---|
 | Changed |
Event which is raised when the Graph contents change
|
| Cleared |
Event which is raised after the Graph is cleared of its contents
|
| ClearRequested |
Event which is raised just before the Graph is cleared of its contents
|
| Merged |
Event which is raised when a Merge operation is completed on the Graph
|
| MergeRequested |
Event which is raised when a Merge operation is requested on the Graph
|
| TripleAsserted |
Event which is raised when a Triple is asserted in the Graph
|
| TripleRetracted |
Event which is raised when a Triple is retracted from the Graph
|
Fields
Extension Methods| Name | Description | |
|---|---|---|
 | AddToList(INode, IEnumerableINode) | Overloaded.
Adds new items to the end of a list (aka a RDF collection).
(Defined by Extensions.) |
| AddToListT(INode, IEnumerableT, FuncT, INode) | Overloaded.
Adds new items to the end of a list (aka a RDF collection).
(Defined by Extensions.) |
| AsDynamic |
Dynamically wraps a graph.
(Defined by DynamicExtensions.) |
| Assert |
Asserts a new Triple in the Graph.
(Defined by Extensions.) |
| AssertList(IEnumerableINode) | Overloaded.
Asserts a list as a RDF collection and returns the node that represents the root of the RDF collection.
(Defined by Extensions.) |
| AssertList(INode, IEnumerableINode) | Overloaded.
Asserts a list as a RDF collection using an existing node as the list root.
(Defined by Extensions.) |
| AssertListT(IEnumerableT, FuncT, INode) | Overloaded.
Asserts a list as a RDF collection and returns the node that represents the root of the RDF collection.
(Defined by Extensions.) |
| AssertListT(INode, IEnumerableT, FuncT, INode) | Overloaded.
Asserts a list as a RDF collection using an existing node as the list root.
(Defined by Extensions.) |
| ExecuteQuery(String) | Overloaded.
Executes a SPARQL Query on a Graph.
(Defined by GraphExtensions.) |
| ExecuteQuery(SparqlParameterizedString) | Overloaded.
Executes a SPARQL Query on a Graph.
(Defined by GraphExtensions.) |
| ExecuteQuery(SparqlQuery) | Overloaded.
Executes a SPARQL Query on a Graph.
(Defined by GraphExtensions.) |
| ExecuteQuery(IRdfHandler, ISparqlResultsHandler, String) | Overloaded.
Executes a SPARQL Query on a Graph handling the results using the handlers provided.
(Defined by GraphExtensions.) |
| ExecuteQuery(IRdfHandler, ISparqlResultsHandler, SparqlParameterizedString) | Overloaded.
Executes a SPARQL Query on a Graph handling the results using the handlers provided.
(Defined by GraphExtensions.) |
| ExecuteQuery(IRdfHandler, ISparqlResultsHandler, SparqlQuery) | Overloaded.
Executes a SPARQL Query on a Graph handling the results using the handlers provided.
(Defined by GraphExtensions.) |
| GetListAsTriples |
Gets all the Triples that make up a list (aka a RDF collection).
(Defined by Extensions.) |
| GetListItems |
Gets all the Nodes which are the items of the list (aka the RDF collection).
(Defined by Extensions.) |
| GetListNodes |
Gets all the Nodes which are the intermediate nodes in the list (aka the RDF collection). These represents the nodes used to link the actual items of the list together rather than the actual items of the list.
(Defined by Extensions.) |
| LoadFromEmbeddedResource(String) | Overloaded.
Loads RDF data from an Embedded Resource into a Graph.
(Defined by GraphExtensions.) |
| LoadFromEmbeddedResource(String, IRdfReader) | Overloaded.
Loads RDF data from an Embedded Resource into a Graph.
(Defined by GraphExtensions.) |
| LoadFromFile(String) | Overloaded.
Loads RDF data from a file into a Graph.
(Defined by GraphExtensions.) |
| LoadFromFile(String, IRdfReader) | Overloaded.
Loads RDF data from a file into a Graph.
(Defined by GraphExtensions.) |
| LoadFromString(String) | Overloaded.
Loads RDF data from a String into a Graph.
(Defined by GraphExtensions.) |
| LoadFromString(String, IRdfReader) | Overloaded.
Loads RDF data from a String into a Graph.
(Defined by GraphExtensions.) |
| LoadFromUri(Uri) | Overloaded.
Loads RDF data from a URI into a Graph.
(Defined by GraphExtensions.) |
| LoadFromUri(Uri, IRdfReader) | Overloaded.
Loads RDF data from a URI into a Graph.
(Defined by GraphExtensions.) |
| RemoveFromList(INode, IEnumerableINode) | Overloaded.
Removes the given items from a list (aka a RDF collection), if an item occurs multiple times in the list all occurrences will be removed.
(Defined by Extensions.) |
| RemoveFromListT(INode, IEnumerableT, FuncT, INode) | Overloaded.
Removes the given items from a list (aka a RDF collection), if an item occurs multiple times in the list all occurrences will be removed.
(Defined by Extensions.) |
| Retract |
Retracts a Triple from the Graph.
(Defined by Extensions.) |
| RetractList |
Retracts a List (aka a RDF collection).
(Defined by Extensions.) |
| SaveToFile(String) | Overloaded.
Saves a Graph to a File.
(Defined by GraphExtensions.) |
| SaveToFile(String, IRdfWriter) | Overloaded.
Saves a Graph to a File.
(Defined by GraphExtensions.) |
| SaveToFile(String, IStoreWriter) | Overloaded.
Saves a Graph to a File.
(Defined by GraphExtensions.) |
| SaveToStream(TextWriter, IRdfWriter) | Overloaded.
Saves a Graph to a stream.
(Defined by GraphExtensions.) |
| SaveToStream(TextWriter, IStoreWriter) | Overloaded.
Saves a Graph to a stream.
(Defined by GraphExtensions.) |
| SaveToStream(String, TextWriter) | Overloaded.
Save a graph to a stream, determining the type of writer to use by the output file name.
(Defined by GraphExtensions.) |
RemarksWhen 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(), PersistDeletedTriples() and PersistGraph() methods. If you return true for the property then the PersistInsertedTriples() and PersistDeletedTriples() 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.
See Also